DFX_Text

發行項
02/28/2013

傳輸CString的欄位資料成員之間的資料 CDaoRecordset 物件和資料來源上的資料錄的資料行。

void AFXAPI DFX_Text(
   CDaoFieldExchange* pFX,
   LPCTSTR szName,
   CString& value,
   int nPreAllocSize = AFX_DAO_TEXT_DEFAULT_SIZE,
   DWORD dwBindOptions = AFX_DAO_ENABLE_FIELD_CACHE 
);

參數

pFX
變數的指標，類別的物件 CDaoFieldExchange。這個物件包含用於定義每個呼叫的函式的內容資訊。
szName
資料行的名稱。
value
儲存在指定的資料成員的值，要傳送的值。從資料錄集傳送至資料來源，型別的值 CString，取自指定的資料成員。從資料來源傳輸到資料錄集，此值則儲存在指定的資料成員。
nPreAllocSize
架構 preallocates 這個數量的記憶體。若您的資料還大，架構會將配置所需更多的空間。對於較佳的效能，設定這個大小夠大，以避免重新配置的值。
dwBindOptions
可讓您利用 MFC 的雙重緩衝的機制來偵測已變更的資料錄集欄位的一個選項。預設值， AFX_DAO_ENABLE_FIELD_CACHE，使用雙重緩衝。其他可能的值是AFX_DAO_DISABLE_FIELD_CACHE。如果您指定此值時，MFC 會執行任何檢查此欄位上。您必須呼叫 SetFieldDirty 和 SetFieldNull 自己。

注意事項

您可以控制是否資料是雙重緩衝預設情況下，藉由設定 CDaoRecordset::m_bCheckCacheForDirtyFields。

注意事項
您可以控制是否資料是雙重緩衝預設情況下，藉由設定 CDaoRecordset::m_bCheckCacheForDirtyFields。

備註

對應資料型別之間 DAO_CHAR 在 DAO 中 (或者，如果該符號 _UNICODE 定義時， DAO_WCHAR) 和型別 CString 在資料錄集。

範例

這個範例會示範數個呼叫DFX_Text。請注意也至兩個呼叫 CDaoFieldExchange::SetFieldType。您必須撰寫第一次呼叫SetFieldType ，其 DFX 呼叫。第二個呼叫以及其相關 DFX 所產生之類別的程式碼精靈通常寫入呼叫。

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