DFX_Text

發行項
06/10/2015

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

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
架構預先配置的記憶體數量。如果資料是更大，架構會配置更多空間視需要。為獲得較佳的效能，請設定這個大小調整為較大的值無法轉散發。
dwBindOptions
可讓您利用偵測到資料錄集欄位 MFC 的雙重緩衝機制已變更的選項。預設 AFX_DAO_ENABLE_FIELD_CACHE，，請使用 double 緩衝區。其他可能的值為 AFX_DAO_DISABLE_FIELD_CACHE。如果您指定值， MFC 就不會檢查這個欄位。您必須呼叫 SetFieldDirty 和 SetFieldNull 。

注意事項

您可以控制資料是否預設為設定緩衝區的 CDaoRecordset::m_bCheckCacheForDirtyFields。

注意事項
您可以控制資料是否預設為設定緩衝區的 CDaoRecordset::m_bCheckCacheForDirtyFields。

備註

資料對應至資料錄集的型別在 DAO 的 DAO_CHAR (，或者，如果符號 _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);
}