CRecordset::DoBulkFieldExchange

 

Publicado: abril de 2016

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.)

Sintaxe

      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

Exception

Condition

Esse método pode lançar exceções do tipo CDBException*.

Requisitos

Cabeçalho: afxdb.h

Consulte também

Classe de CRecordset
Gráfico da hierarquia
CRecordset::m_nFields
CRecordset::m_nParams
CRecordset::DoFieldExchange
CRecordset::GetFieldValue
Classe de CFieldExchange
Registrar funções de troca de campos