CRecordset::DoBulkFieldExchange

[アーティクル]
08/09/2011

データのバルク行をデータソースからレコードセットへ転送します。 Bulk RFX (バルクレコードフィールドエクスチェンジ) を実装します。

virtual void DoBulkFieldExchange( 
   CFieldExchange* pFX  
);

パラメーター

pFX
CFieldExchange オブジェクトへのポインターを返します。このオブジェクトは、フィールド交換操作のコンテキストを指定するために、前もってフレームワークによって設定されています。

解説

バルク行フェッチが実装されている場合は、データソースからレコードセットオブジェクトにデータを自動的に転送するために、フレームワークがこのメンバー関数を呼び出します。また、DoBulkFieldExchange は、レコードセットの選択のための SQL ステートメント文字列のパラメータープレースホルダーに、パラメーターデータメンバーを連結します。

バルク行フェッチが実装されていない場合、フレームワークは DoFieldExchange を呼び出します。バルク行フェッチを実装するには、Open メンバー関数でパラメーター dwOptions に CRecordset::useMultiRowFetch オプションを指定します。

注意

DoBulkFieldExchange は、CRecordset から派生したクラスを使っている場合だけ使用できます。 CRecordset から直接レコードセットオブジェクトを作成した場合は、GetFieldValue メンバー関数を呼び出してデータを取得する必要があります。

Bulk RFX (バルクレコードフィールドエクスチェンジ) は、RFX (レコードフィールドエクスチェンジ) に似ています。データは、データソースからレコードセットオブジェクトへ自動的に転送されます。しかし、AddNew、Edit、Delete、または Update を呼び出して変更をデータソースへ戻すことはできません。現時点で CRecordset クラスには、データのバルク行を更新する機構は用意されていませんが、ODBC API の関数 SQLSetPos を使うことによって独自の関数を作成できます。

ClassWizard は、レコードフィールドエクスチェンジをサポートしていません。したがって、Bulk RFX 関数の呼び出しを作成して DoBulkFieldExchange を手動でオーバーライドする必要があります。これらの関数の詳細については、「レコードフィールドエクスチェンジ (RFX) 関数」を参照してください。

バルク行フェッチの詳細については、資料を参照してくださいレコードセット：一括 (ODBC) 内のレコードをフェッチ。関連情報については、「レコードフィールドエクスチェンジ (RFX)」を参照してください。