CRecordset::DoBulkFieldExchange
Chamado para trocar linhas em massa de dados da fonte de dados ao conjunto de registros. Troca do campo do registro de volume implements (RFX em massa.)
virtual void DoBulkFieldExchange(
CFieldExchange* pFX
);
Parâmetros
- pFX
Um ponteiro para um objeto de CFieldExchange . A estrutura configurado já terá esse objeto para especificar um contexto para a operação de troca do campo.
Comentários
Quando buscar em massa de linha é implementado, a estrutura chama essa função de membro para transferir dados automaticamente de fonte de dados ao seu objeto do conjunto de registros. DoBulkFieldExchange também associa os membros de dados do parâmetro, se houver, aos espaços reservados de parâmetro na cadeia de caracteres da instrução SQL para a seleção do conjunto de registros.
Se a busca em massa de linha não é implementado, a estrutura chama DoFieldExchange. Para implementar a linha em massa que pesquisa, você deve especificar a opção de CRecordset::useMultiRowFetch de parâmetro de dwOptions na função de membro de Abrir .
Dica
DoBulkFieldExchange está disponível somente se você estiver usando uma classe derivada de CRecordset.Se você criou um objeto do conjunto de registros diretamente de CRecordset, você deve chamar a função de membro de GetFieldValue para recuperar dados.
A troca em massa do campo do registro (RFX em massa) é semelhante à troca do campo do registro (RFX). Os dados são transferidos automaticamente de fonte de dados ao objeto do conjunto de registros. Em o entanto, você não pode chamar AddNew, Editar, Excluir, ou Atualizar para transferir alterações de volta para a fonte de dados. a classe CRecordset atualmente não fornece um mecanismo para atualizar linhas em massa de dados; no entanto, você pode escrever suas próprias funções usando a função da API SQLSetPosODBC.
Observe que ClassWizard não oferece suporte a troca em massa do campo do registro; portanto, você deve substituir DoBulkFieldExchange manualmente escrevendo chamadas a funções de volume RFX. Para obter mais informações sobre essas funções, consulte o tópico Funções de Exchange do campo do registro.
Para obter mais informações sobre a linha em massa que pesquisa, consulte o artigo conjunto de registros: Para buscar registros em massa (ODBC). Para informações relacionadas, consulte o artigo Registrar o campo information Exchange (RFX).
Exceções
Esse método pode lançar exceções do tipo CDBException*.
Requisitos
Cabeçalho: afxdb.h