CRecordset::DoBulkFieldExchange

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

データのバルク行をデータソースからレコードセットへ転送します。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)」を参照してください。