DFX_Text

项目
06/09/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
数据列的名称。
值
在指定的数据成员中存储的值 - 要传输的值。在前向从记录集移动到数据源，该值类型，CString，从指定的数据成员进行的。在前向从数据源移动到记录集，可以在指定的数据成员来存储。
nPreAllocSize
框架预分配此内存量。如果数据变大，框架将分配更多空间。需要。对于更好的性能，请将此范围设置为足够大值阻止重新分配。
dwBindOptions
允许您利用 MFC 中检测的记录集字段双缓冲机制更改的选项。默认，AFX_DAO_ENABLE_FIELD_CACHE，使用双缓冲。另一个可能的值为 AFX_DAO_DISABLE_FIELD_CACHE。如果指定此值，MFC 不执行此检查字段。必须调用 SetFieldDirty 和 SetFieldNull。

备注

可以控制数据是否设置缓存的默认双 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);
}