Troca de campo do registro: Usando as funções RFX

Artigo
08/01/2011

Este tópico explica como usar as chamadas de função RFX que constituem o corpo do seu DoFieldExchange substituição.

Observação
Este tópico se aplica a classes derivadas de CRecordset no qual linha em massa buscando não foi implementada. Se você estiver usando a busca de linha em massa, troca de campo de registro de massa (Bulk RFX) é implementada. RFX de massa é semelhante a RFX. Para entender as diferenças, consulte Recordset: Buscar registros em massa (ODBC).

As funções globais RFX trocam dados entre as colunas nos dados de origem e campo dados membros de registros. Escreva o seu conjunto de registros chama a função RFX DoFieldExchange a função de membro. Este tópico descreve as funções brevemente e mostra os tipos de dados para o qual RFX funções estão disponíveis. 43 De nota técnica descreve como escrever suas próprias funções RFX para tipos de dados adicionais.

Sintaxe da função RFX

Cada função RFX usa três parâmetros (e alguns levar um parâmetro opcional do quarto ou quinto):

Um ponteiro para uma CFieldExchange objeto. Você simplesmente passar junto a pFX ponteiro é passado para DoFieldExchange.
O nome da coluna como ele aparece na fonte de dados.
O nome do membro de dados do campo correspondente ou membro de dados de parâmetro na classe de conjunto de registros.
(Opcional) Em algumas das funções, o comprimento máximo da seqüência de caracteres ou array que estão sendo transferidos. Esse padrão é de 255 bytes, mas deseja alterá-lo. O tamanho máximo se baseia o tamanho máximo de um CString objeto — INT_MAX (2.147.483.647) bytes — mas você provavelmente encontrará os limites de driver antes desse tamanho.
(Opcional) No RFX_Text a função, às vezes, você usar um quinto parâmetro para especificar o tipo de dados de uma coluna.

Para obter mais informações, consulte as funções RFX em Macros e Globals na Referência da biblioteca de classe. Para obter um exemplo de quando você pode tornar especial usar os parâmetros, consulte Recordset: Obtendo somas e outros resultados agregados (ODBC).

Tipos de dados RFX

A biblioteca de classes fornece funções RFX de transferência de muitos tipos de dados diferentes entre a fonte de dados e conjuntos de registros. A lista a seguir resume as funções RFX pelo tipo de dados. Em casos onde você deve escrever seus próprio chamadas de função RFX, selecione essas funções por tipo de dados.

Function	Data type
RFX_Bool	BOOL
RFX_Byte	BYTE
RFX_Binary	CByteArray
RFX_Double	double
RFX_Single	float
RFX_Int	int
RFX_Long	long
RFX_LongBinary	CLongBinary
RFX_Text	CString
RFX_Date	CTime

Para obter mais informações, consulte a documentação da função RFX em Macros e Globals na Referência da biblioteca de classe. Para obter informações sobre como tipos de dados do C++ são mapeados para tipos de dados SQL, consulte a tabela que ANSI SQL dados tipos mapeados para tipos de dados de C++ em SQL: Tipos de SQL e C++ dados (ODBC).