Compartilhar via


Troca de campo de registro: usando RFX

Este tópico explica o que você faz para utilizar o RFX em relação ao que o framework realiza.

Observação

Este tópico aplica-se a classes derivadas de CRecordset nas quais o fetch de linha em massa não foi implementado. Se você estiver usando a busca de linha em massa, a troca de campos de registros em massa (RFX em massa) será implementada. Bulk RFX é semelhante à RFX. Para entender as diferenças, confira Recordset: Recuperação de registros em massa (ODBC).

Os seguintes tópicos contêm informações relacionadas:

A tabela a seguir mostra sua função em relação ao que a estrutura faz por você.

Usando RFX: você e a estrutura

Você A estrutura
Declare suas classes de conjunto de registros com um assistente. Especifique nomes e tipos de dados de membros de dados de campo. O assistente deriva uma classe CRecordset e grava uma substituição DoFieldExchange para você, incluindo uma chamada de função RFX para cada membro de dados de campo.
(Opcional) Adicione manualmente todos os membros de dados de parâmetro necessários à classe. Adicione manualmente uma chamada de função RFX para DoFieldExchange a cada membro de dados de parâmetro, adicione uma chamada para CFieldExchange::SetFieldType ao grupo de parâmetros e especifique o número total de parâmetros em m_nParams. Confira Conjunto de registros: parametrizando um conjunto de registros (ODBC).
(Opcional) Associe manualmente colunas adicionais a membros de dados de campo. Incremente manualmente m_nFields. Confira Recordset: associação dinâmica de colunas de dados (ODBC).
Construa um objeto de sua classe de conjunto de registros. Antes de usar o objeto, defina os valores dos membros de dados dos parâmetros, caso existam. Para maior eficiência, a estrutura pré-vincula os parâmetros usando ODBC. Quando você passa valores de parâmetro, a estrutura os passa para a fonte de dados. Somente os valores de parâmetro são enviados para requisições, a menos que as cadeias de classificação e/ou de filtro tenham sido alteradas.
Abra um objeto de conjunto de registros usando CRecordset::Open. Executa a consulta do conjunto de registros, associa colunas a membros de dados de campo do conjunto de registros e chama DoFieldExchange para trocar dados entre o primeiro registro selecionado e os membros de dados de campo do conjunto de registros.
Role o conjunto de registros usando CRecordset::Move ou um comando de menu ou de barra de ferramentas. Chama DoFieldExchange para transferir dados para os membros de dados de campo do novo registro atual.
Adicionar, atualizar e excluir registros. Chama DoFieldExchange para transferir dados para a fonte de dados.

Confira também

RFX (troca de campo de registro)
Troca de campos de registro: como funciona a RFX
Conjunto de registros: obtendo SUM e outros resultados agregados (ODBC)
Classe CRecordset
Classe CFieldExchange
Macros, funções globais e variáveis globais