DFX_Text

Artigo
06/10/2015

Dados de CString das transferências entre os membros de dados do campo de um objeto de CDaoRecordset 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. Esse objeto contém informações para definir o contexto para 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 do conjunto de registros com a fonte de dados, o valor, do tipo CString, é obtido do membro de dados especificado. Para uma transferência da 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 mais espaço alocado quando necessário. Para melhor desempenho, defina esse tamanho em um valor grande o bastante para evitar redistribuições.
dwBindOptions
Uma opção que permite usufruir o mecanismo de proteção duplo MFC para detectar os campos do conjunto de registros que foram alterados. A opção, AFX_DAO_ENABLE_FIELD_CACHE, use a proteção duplo. Outro valor possível é AFX_DAO_DISABLE_FIELD_CACHE. Se você especificar esse valor, o MFC não faz nenhuma verificação nesse campo. Você deve chamar SetFieldDirty e SetFieldNull você mesmo.

Dica

Você pode controlar se os dados são duplicadas em buffer por padrão definindo CDaoRecordset::m_bCheckCacheForDirtyFields.

Comentários

Os dados são mapeados entre o tipo DAO_CHAR em DAO (ou, se o símbolo _UNICODE é definido, DAO_WCHAR) e o tipo CString no conjunto de registros.

Exemplo

Este exemplo mostra várias chamadas a DFX_Text. Aviso também as duas chamadas a CDaoFieldExchange::SetFieldType. Você deve escrever a primeira chamada a SetFieldType e à sua chamada de DFX . O segundo chamada e seus chamadas de DFX associados são gravados normalmente 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);
}