DFX_Text

Artigo
02/25/2013

Transferências de CString dados entre os membros de dados de campo de um CDaoRecordset objeto e colunas de um registro na fonte de dados.

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
Um ponteiro para um objeto da classe CDaoFieldExchange.Este objeto contém informações para definir o contexto de cada chamada da função.
szName
O nome de uma coluna de dados.
valor
O valor armazenado no membro de dados indicado — o valor a ser transferido.Para uma transferência de conjunto de registros à fonte de dados, o valor do tipo CString, é obtido do membro de dados especificado.Para uma transferência de fonte de dados ao conjunto de registros, o valor é armazenado no membro de dados especificado.
nPreAllocSize
A estrutura preallocates essa quantidade de memória.Se os dados forem maiores, a estrutura será alocado mais espaço conforme necessário.Para obter melhor desempenho, defina este tamanho para um valor grande o suficiente para evitar realocações a.
dwBindOptions
Uma opção que permite aproveitar o mecanismo de armazenamento em buffer duplo do MFC para detectar os campos de conjunto de registros que foram alterados.O padrão AFX_DAO_ENABLE_FIELD_CACHE, usa o buffer duplo.O valor possível é AFX_DAO_DISABLE_FIELD_CACHE.Se você especificar esse valor, a MFC não nenhuma verificação neste campo.Você deve chamar SetFieldDirty e SetFieldNull si mesmo.

Observação

Você pode controlar se a dados são duplos em buffer por padrão, definindo CDaoRecordset::m_bCheckCacheForDirtyFields.

Observação
Você pode controlar se a dados são duplos em buffer por padrão, definindo CDaoRecordset::m_bCheckCacheForDirtyFields.

Comentários

Dados são mapeados entre tipo DAO_CHAR no DAO (ou, se o símbolo Unicode for definido, DAO_WCHAR) e digite CString no conjunto de registros.

Exemplo

Este exemplo mostra várias chamadas para DFX_Text.Observe também as duas chamadas para CDaoFieldExchange::SetFieldType.Você deve escrever a primeira chamada para SetFieldType e seus DFX chamar.A segunda chamada e seu associado DFX chamadas normalmente são gravadas pelo Assistente de código que gerou a classe.

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