次の方法で共有


RFX_Text

CRecordset オブジェクトのフィールド データ メンバーと ODBC の型 SQL_LONGVARCHARSQL_CHARSQL_VARCHARSQL_DECIMAL、または SQL_NUMERICのデータ ソースのレコードの列間のコピーの CString のデータ。

void RFX_Text(
   CFieldExchange* pFX,
   const char* szName,
   CString& value,
   int nMaxLength = 255,
   int nColumnType = SQL_VARCHAR,
   short nScale = 0 
);

パラメーター

  • pFX
    クラス CFieldExchangeのオブジェクトへのポインター。このオブジェクトは、関数の各呼び出しのコンテキストを定義するための情報が含まれています。CFieldExchange のオブジェクトが指定できる操作についての詳細については、技術情報 レコード フィールド エクスチェンジ: RFX の動作のしくみを参照してください。

  • szName
    データ列の名前。

  • value
    指定されたデータ メンバーに格納される値 —コピーする値。レコードセットからデータ ソースへのコピーの場合、値 CStringは、型指定されたデータ メンバーから、取得されます。データ ソースからレコードセットにコピーの場合、値は指定されたデータ メンバーに格納されます。

  • nMaxLength
    転送される文字列または配列の最大許容長。nMaxLength の既定値は 255 です。有効な値は INT_MAXに 1 です。フレームワークは、データのこの領域を割り当てます。最適なパフォーマンスを得るために、予想される最大データ項目を格納するのに十分な大きさの値を渡します。

  • nColumnType
    主にパラメーターに使用されます。パラメーターのデータ型を示す整数。型は、フォーム SQL_XXXODBC データ型です。

  • nScale
    ODBC の型 SQL_DECIMALSQL_NUMERICの値に対してスケールを指定します。nScale は、パラメーター値を設定する場合に便利です。詳細については、 *" ODBC Programmer's Reference "*の " Appendix 17 C のトピック 「精度で、スケーリング、期間、表示サイズ」を参照してください。

解説

これらの型のすべてのデータ ソースのデータは、レコードセットの CString に対してマップされます。

使用例

この例では RFX_Textに複数の呼び出しを次に示します。また、表記 CFieldExchange::SetFieldTypeへの 2 回の呼び出し。パラメーターに SetFieldType と RFX の呼び出しに呼び出しを記述します。出力列の呼び出しと関連 RFX の呼び出しは、コード ウィザード、一般に書き込まれます。

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);
}

必要条件

Header: afxdb.h

参照

関連項目

RFX_Bool

RFX_Long

RFX_Int

RFX_Single

RFX_Double

RFX_Date

RFX_Byte

RFX_Binary

RFX_LongBinary

CFieldExchange::SetFieldType

概念

MFC マクロとグローバル