CRecordset::DoFieldExchange

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

レコードセットのフィールドデータメンバーとデータソース上の対応するレコードとの間で (双方向で) データを交換するために呼び出されます。 RFX (レコードフィールドエクスチェンジ) を実装します。

virtual void DoFieldExchange( 
   CFieldExchange* pFX  
);

パラメーター

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

解説

バルク行フェッチが実装されていない場合は、レコードセットオブジェクトのフィールドデータメンバーとデータソースの現在のレコードの対応する列との間で自動的にデータを交換するために、フレームワークがこのメンバーを呼び出します。また、もしパラメーターデータメンバーがあれば、DoFieldExchange をレコードの選択のための SQL ステートメント文字列のパラメータープレースホルダーに連結します。

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

注意

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

Exchange レコードフィールドエクスチェンジ (RFX) と呼ばれる、フィールドのデータの両方の方向で機能します。レコードセットオブジェクトのフィールドデータメンバーからのデータソースとレコードセットオブジェクトにデータソースのレコードからのレコードのフィールド。

派生させたレコードセットクラスに DoFieldExchange を実装するために必要な作業は、ClassWizard を使用してクラスを作成し、フィールドデータメンバーの名前とデータ型を指定することだけです。パラメーターデータメンバーを指定したり動的に連結する列を扱うために、ClassWizard が記述したコードにコードを追加することもあります。詳細についてを参照してください「レコードセット：データ列 (ODBC) の動的な連結。

ClassWizard を使用して派生レコードセットクラスを宣言すると、次の例のような DoFieldExchange 関数のオーバーライドが記述されます。

void CCustomer::DoFieldExchange(CFieldExchange* pFX)
{
   pFX->SetFieldType(CFieldExchange::outputColumn);
   // Macros such as RFX_Text() and RFX_Int() are dependent on the
   // type of the member variable, not the type of the field in the database.
   // ODBC will try to automatically convert the column value to the requested type
   RFX_Long(pFX, _T("[CustomerID]"), m_CustomerID);
   RFX_Text(pFX, _T("[ContactFirstName]"), m_ContactFirstName);
   RFX_Text(pFX, _T("[PostalCode]"), m_PostalCode);
   RFX_Text(pFX, _T("[L_Name]"), m_L_Name);
   RFX_Long(pFX, _T("[BillingID]"), m_BillingID);

   pFX->SetFieldType(CFieldExchange::inputParam);
   RFX_Text(pFX, _T("Param"), m_strParam);
}

RFX 関数の詳細については、「レコードフィールドエクスチェンジ (RFX) 関数」を参照してください。

詳細な例と詳細についてDoFieldExchange、記事を参照してくださいレコードフィールドエクスチェンジ:RFX の動作。 RFX の一般的な情報については、「レコードフィールドエクスチェンジ (RFX)」を参照してください。