レコードフィールドエクスチェンジ (RFX) 関数

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

更新 : 2007 年 11 月

ここでは、レコードセットオブジェクトとデータソース間のデータ転送を自動化したり、データにその他の処理を行ったりする、レコードフィールドエクスチェンジ (RFX、バルク RFX、および DFX) 関数の一覧を示します。

ODBC ベースのクラスを使用し、バルク行フェッチを実装している場合は、データソース列に対応する各データメンバに対してバルク RFX 関数を呼び出すことによって、CRecordset の DoBulkFieldExchange メンバ関数を手動でオーバーライドする必要があります。

ODBC ベースのクラスにバルク行フェッチを実装していない場合、または DAO ベースのクラスを使用している場合は、ClassWizard で、レコードセットの各フィールドデータメンバに対して、RFX 関数 (ODBC クラスの場合) または DFX 関数 (DAO クラスの場合) を呼び出して、CRecordset または CDaoRecordset の DoFieldExchange メンバ関数をオーバーライドします。

レコードフィールドエクスチェンジ関数は、フレームワークが DoFieldExchange または DoBulkFieldExchange を呼び出すたびに、データを転送します。それぞれの関数が固有のデータ型を転送します。

これらの関数の使い方の詳細については、「レコードフィールドエクスチェンジ : RFX の動作のしくみ」を参照してください。バルク行フェッチの詳細については、「レコードセット : バルク行フェッチ (ODBC)」を参照してください。

動的に連結するデータ列については、RFX 関数または DFX 関数を手動で呼び出すこともできます。詳細については、「レコードセット : データ列を動的に結び付ける方法 (ODBC)」を参照してください。また、独自のカスタム RFX ルーチンまたは DFX ルーチンを記述することもできます。詳細については、ODBC の場合は「テクニカルノート 43: RFX ルーチン」、DAO の場合は「テクニカルノート 53: DAO データベースクラス用カスタム DFX ルーチン」を参照してください。

DoFieldExchange 関数と DoBulkFieldExchange 関数で使用する RFX 関数とバルク RFX 関数の例については、「RFX_Text」と「RFX_Text_Bulk」を参照してください。DFX 関数は RFX 関数によく似ています。

RFX 関数 (ODBC)

RFX_Binary	CByteArray 型のバイト配列を転送します。
RFX_Bool	ブール型のデータを転送します。
RFX_Byte	シングルバイトのデータを転送します。
RFX_Date	CTime または TIMESTAMP_STRUCT を使用して時刻と日付のデータを転送します。
RFX_Double	倍精度浮動小数点型のデータを転送します。
RFX_Int	整数型のデータを転送します。
RFX_Long	長整数型のデータを転送します。
RFX_LongBinary	CLongBinary クラスのオブジェクトを使用して、バイナリラージオブジェクト (BLOB: Binary Large Object) データを転送します。
RFX_Single	浮動小数点型のデータを転送します。
RFX_Text	文字列型のデータを転送します。

バルク RFX 関数 (ODBC)

RFX_Binary_Bulk	バイトデータの配列を転送します。
RFX_Bool_Bulk	ブール型のデータの配列を転送します。
RFX_Byte_Bulk	シングルバイトの配列を転送します。
RFX_Date_Bulk	TIMESTAMP_STRUCT 型のデータの配列を転送します。
RFX_Double_Bulk	倍精度浮動小数点型のデータの配列を転送します。
RFX_Int_Bulk	整数型のデータの配列を転送します。
RFX_Long_Bulk	長整数型のデータの配列を転送します。
RFX_Single_Bulk	浮動小数点型のデータの配列を転送します。
RFX_Text_Bulk	LPSTR 型のデータの配列を転送します。

DFX 関数 (DAO)

DFX_Binary	CByteArray 型のバイト配列を転送します。
DFX_Bool	ブール型のデータを転送します。
DFX_Byte	シングルバイトのデータを転送します。
DFX_Currency	COleCurrency 型の通貨データを転送します。
DFX_DateTime	COleDateTime 型の時刻と日付データを転送します。
DFX_Double	倍精度浮動小数点型のデータを転送します。
DFX_Long	長整数型のデータを転送します。
DFX_LongBinary	CLongBinary クラスのオブジェクトを使用して、バイナリラージオブジェクト (BLOB) データを転送します。DAO の場合は、DFX_Binary の使用をお勧めします。
DFX_Short	短整数型のデータを転送します。
DFX_Single	浮動小数点型のデータを転送します。
DFX_Text	文字列型のデータを転送します。