RFX_Text

發行項
02/28/2013

傳輸CString的欄位資料成員之間的資料CRecordset物件和資料行的資料來源的 ODBC 型別的資料錄的 SQL_LONGVARCHAR， SQL_CHAR， SQL_VARCHAR， SQL_DECIMAL，或 SQL_NUMERIC。

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。有效的值是 1 到 INT_MAX。架構會將資料配置的空間。為了達到最佳效能，傳遞一個值大到足以容納您所預期的最大資料項目。
nColumnType
主要用於參數。整數，表示參數的資料型別。型別是 ODBC 資料型別形式的 SQL_XXX。
nScale
指定的比例的 ODBC 型別的值 SQL_DECIMAL 或 SQL_NUMERIC。 nScale有用時才設定參數值。如需詳細資訊，請參閱主題"有效位數、小數位數、長度、及顯示大小」中的附錄 d ODBC SDK 程式設計人員參考。

備註

所有這些類型的資料來源中的資料會對應到及從CString在記錄集中。

範例

這個範例會示範數個呼叫RFX_Text。請注意也至兩個呼叫CFieldExchange::SetFieldType。參數中，您必須撰寫的呼叫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);
}