CDaoRecordset::DoFieldExchange

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

更新 : 2007 年 11 月

レコードセットのフィールドデータメンバと、データソースの現在のレコードの対応する列との間で、自動的にデータを交換するために、フレームワークが呼び出します。

virtual void DoFieldExchange(
   CDaoFieldExchange* pFX 
);

パラメータ

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

解説

また、パラメータデータメンバを、レコードセットの選択に使用する SQL ステートメント文字列のパラメータプレースホルダに連結します。フィールドデータの交換は、DAO レコードフィールドエクスチェンジ (DFX) と呼ばれ、レコードセットオブジェクトのフィールドデータメンバからデータソースのレコードのフィールドに、データソースのレコードから、レコードセットオブジェクトへの両方向で動作します。動的に列を連結しているときは、DoFieldExchange を実装する必要はありません。

派生させたレコードセットクラスに DoFieldExchange を実装するために必要な作業は、ClassWizard を使用してクラスを作成し、フィールドデータメンバの名前とデータ型を指定することだけです。ClassWizard がパラメータデータメンバを指定するために記述した内容に、コードを追加する場合もあります。すべてのフィールドを動的に連結するときは、パラメータデータメンバを指定していない場合は、この関数は非アクティブになります。

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

void CCustSet::DoFieldExchange(CDaoFieldExchange* pFX)
{
   pFX->SetFieldType(CDaoFieldExchange::param);
   DFX_Text(pFX, _T("Param"), m_strParam);
   pFX->SetFieldType(CDaoFieldExchange::outputColumn);
   DFX_Short(pFX, _T("EmployeeID"), m_EmployeeID);
   DFX_Text(pFX, _T("LastName"), m_LastName);
   DFX_Short(pFX, _T("Age"), m_Age);
   DFX_DateTime(pFX, _T("hire_date"), m_hire_date);
   DFX_DateTime(pFX, _T("termination_date"), m_termination_date);

   CDaoRecordset::DoFieldExchange(pFX);
}