DFX_Text

Artigo
08/25/2010

Transfere CString dados entre os membros de dados do 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 de classe CDaoFieldExchange.Este objeto contém informações para definir o contexto para cada telefonar 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 sistema autônomo dados maiores, a estrutura irá alocar mais espaço conforme necessário.Para obter um melhor desempenho, defina esse dimensionar para um valor grande o suficiente para impedir a realocações a.
dwBindOptions
Uma opção que permite que você possa usufruir mecanismo de armazenamento em buffer duplo do MFC para detectar campos do conjunto de registros que foram alterados.O padrão, AFX_DAO_ENABLE_FIELD_CACHE, usa o buffer duplo. O Outros valor possível é AFX_DAO_DISABLE_FIELD_CACHE. Se você especificar esse valor, a MFC não faz nenhuma verificação neste campo.Você deve chamar SetFieldDirty and SetFieldNull você mesmo.

Observação:

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

Observação:
Você pode controlar se os dados estã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 definição, DAO_WCHAR) e digite CString no conjunto de registros.

Exemplo

Este exemplo mostra várias chamadas para DFX_Text. Observe também os dois planos de CDaoFieldExchange::SetFieldType.Você deve escrever a primeira telefonar para SetFieldType e seus DFX telefonar.A segunda telefonar 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);
}