レコードセット : レコードセットの生成と破棄 (ODBC)

  • [アーティクル]

更新 : 2007 年 11 月

このトピックの内容は、MFC ODBC クラスに該当します。

レコードセットを使用するには、まずレコードセット オブジェクトを構築します。次に、その Open メンバ関数を呼び出し、レコードセットのクエリを実行してレコードを選択します。使用済みのレコードセット オブジェクトは閉じて破棄します。

このトピックでは、次の内容について説明します。

  • レコードセットの実行時生成

  • レコードセット オプションの設定

  • レコードセットを閉じる

レコードセットの実行時生成

レコードセット オブジェクトを作成するには、通常アプリケーション固有のレコードセット クラスを事前に定義します。この手順の詳細については、「MFC ODBC コンシューマの追加」を参照してください。

データ ソースからレコードを選択するときは、ダイナセット オブジェクトまたはスナップショット オブジェクトを開きます。ダイナセットとスナップショットのどちらを使うかは、アプリケーションでデータをどのように扱うか、および使っている ODBC ドライバのサポートによって異なります。詳細については、「ダイナセット」および「スナップショット」を参照してください。

レコードセットを開くには

  1. CRecordset の派生クラスのオブジェクトを構築します。

    オブジェクトは、ヒープ上または関数スタック フレーム上に構築します。

  2. 必要に応じてレコードセットの既定の動作を変更します。詳細については、「レコードセット オプションの設定」を参照してください。

  3. オブジェクトの Open メンバ関数を呼び出します。

コンストラクタでは、CDatabase オブジェクトへのポインタを渡すか、NULL を渡して一時データベース オブジェクトを使用します。このオブジェクトは、GetDefaultConnect メンバ関数が返した接続文字列に基づき、フレームワークによって構築され、開かれます。CDatabase オブジェクトは、既にデータ ソースに接続されている場合があります。

Open が呼び出されると SQL が発行され、レコードがデータ ソースから選択されます。レコードが選択されると、先頭のレコードが現在のレコードになります。現在のレコードの各フィールドの値は、レコードセット オブジェクトのフィールド データ メンバに格納されます。レコードが選択されたときは、メンバ関数 IsBOF および IsEOF が 0 を返します。

Open を呼び出すときは、次の手順に従ってください。

  • レコードセットがダイナセットとスナップショットのどちらであるかを指定します。既定では、スナップショットとして開かれます。前方スクロール専用レコードセットを指定することもできます。このレコードセットでは、レコードを 1 つずつ順方向にのみスクロールします。

    既定では、レコードセットは CRecordset クラスのデータ メンバ m_nDefaultType を使います。ウィザードによって、m_nDefaultType を初期化するコードが生成されます。m_nDefaultType は、ウィザードで選択したレコードセットの型に初期化されます。この既定の型を使わずに、開発者自身の定義によるレコードセットの型を使うこともできます。

  • レコードセットが構築した既定の SQL SELECT ステートメントを置き換える文字列を指定します。

  • レコードセットを読み取り専用または追加可能として指定します。既定ではあらゆる更新が可能ですが、上書き禁止または追加のみ可能を指定できます。

次に、アプリケーションで定義されている CStudentSet クラスに対して、上書き禁止のスナップショット オブジェクトを開く例を示します。

// Construct the snapshot object
CStudentSet rsStudent( NULL );
// Set options if desired, then open the recordset
if(!rsStudent.Open(CRecordset::snapshot, NULL, CRecordset::readOnly))
    return FALSE;
// Use the snapshot to operate on its records...

Open を呼び出した後、オブジェクトのメンバ関数とデータ メンバを使ってレコードを処理します。場合によっては、クエリの再実行つまり更新を実行し、Open を呼び出した後にデータ ソースに加えられた変更を反映させる必要があります。詳細については、「レコードセット : パラメータを利用したレコードセット (ODBC)」を参照してください。

08x38eza.alert_note(ja-jp,VS.90).gifヒント :

プログラム開発時に使用した接続文字列は、ユーザーが実際に使用する接続文字列と異なることがあります。この点に関してアプリケーションを汎用化する方法については、「データ ソース : 接続 (ODBC)」を参照してください。

レコードセット オプションの設定

レコードセット オブジェクトの構築後、Open を呼び出してレコードを選択する前に、レコードセットの動作を制御するオプションを設定できます。以下のオプションを指定できます。

  • レコード選択条件を指定するフィルタの指定。

  • レコードの並べ替え順序の指定。

  • レコード選択用のパラメータの設定。実行時のユーザー入力または計算結果に応じてレコードを選択できます。

条件が満たされれば、次のオプションも指定できます。

  • 更新可能なレコードセットでロックをサポートしている場合は、更新用のロック メソッドを指定できます。
08x38eza.alert_note(ja-jp,VS.90).gifメモ :

オプションの設定をレコード選択に反映させるには、Open メンバ関数を呼び出す前に設定する必要があります。

レコードセットを閉じる

使用済みのレコードセットは破棄し、メモリを解放する必要があります。

レコードセットを閉じるには

  1. レコードセットの Close メンバ関数を呼び出します。

  2. レコードセット オブジェクトを破棄します。

    関数のスタック フレーム上にオブジェクトを宣言したときは、スコープから出たときに自動的に破棄されます。そうでない場合は delete 演算子を使います。

Close は、レコードセットの HSTMT ハンドルを解放します。C++ オブジェクトは破棄しません。

参照

概念

レコードセット (ODBC)

レコードセット : スクロール (ODBC)

レコードセット : レコードの追加、更新、削除 (ODBC)