DFX_Text

Artículo
02/19/2013

Datos de CString de las transferencias entre los miembros de datos de campo de un objeto de CDaoRecordset y columnas de un registro en el origen de datos.

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

Parámetros

pFX
Un puntero a un objeto de la clase CDaoFieldExchange.Este objeto contiene información para definir el contexto para cada llamada de función.
szName
El nombre de una columna de datos.
valor
El valor almacenado en el miembro de datos indicado — el valor que se transferirá.Para una transferencia de conjunto de registros al origen de datos, el valor, de CStringcon tipo, se toma del miembro de datos especificado.Para una transferencia del origen de datos al conjunto de registros, el valor se almacena en el miembro de datos especificado.
nPreAllocSize
El marco reserva esta cantidad de memoria.Si los datos son mayor, el marco asignada más espacio según sea necesario.Para mejorar el rendimiento, establezca este tamaño en un valor lo suficientemente grande para evitar reasignaciones.
dwBindOptions
Una opción que permite aprovechar el mecanismo de almacenamiento en búfer doble de MFC para detectar los campos de conjunto de registros que han cambiado.El valor predeterminado, AFX_DAO_ENABLE_FIELD_CACHE, utiliza el búfer doble.El otro valor posible es AFX_DAO_DISABLE_FIELD_CACHE.Si especifica este valor, MFC no tiene ningún comprobar en este campo.Debe llamar a SetFieldDirty y SetFieldNull personalmente.

[!NOTA]

Puede controlar si los datos es double almacenado en búfer de forma predeterminada estableciendo CDaoRecordset::m_bCheckCacheForDirtyFields.

Comentarios

Los datos se asignan entre DAO_CHAR escrito en DAO (o, si el token _UNICODE está definido, DAO_WCHAR) y el tipo CString en el conjunto de registros.

Ejemplo

Este ejemplo muestra varias llamadas a DFX_Text.Observe también las dos llamadas a CDaoFieldExchange::SetFieldType.Debe escribir la primera llamada a SetFieldType y su llamada de DFX .La segunda llamada y sus llamadas asociado de DFX están escritas normalmente por el asistente para código que generó la clase.

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