Compartilhar via


CRecordset::DoBulkFieldExchange

Chamado para trocar linhas em massa de dados da fonte de dados para o conjunto de registros.Implementa em massa a troca de campo de registro (Bulk RFX).

virtual void DoBulkFieldExchange( 
   CFieldExchange* pFX  
);

Parâmetros

  • pFX
    Um ponteiro para um CFieldExchange objeto.A estrutura será já configurou este objeto para especificar um contexto para a operação de troca de campo.

Comentários

Quando buscar a linha em massa é implementado, a estrutura chama esta função de membro transferência automaticamente os dados da fonte de dados para seu objeto de conjunto de registros.DoBulkFieldExchange também vincula seus membros de dados do parâmetro, se houver, para espaços reservados de parâmetros na seqüência de caracteres de demonstrativo SQL para a seleção do conjunto de registros.

Se não for implementada em massa a busca de linha, a estrutura chama DoFieldExchange.Para implementar a busca de linha em massa, você deve especificar o CRecordset::useMultiRowFetch opção da dwOptions parâmetro na em abertofunção de membro .

Observação:

DoBulkFieldExchange está disponível somente se você estiver usando uma classe derivada de CRecordset. Se você tiver criado um objeto conjunto de registros diretamente de CRecordset, você deve telefonar o GetFieldValuefunção de membro para recuperar dados.

Troca de campo de registro em massa (Bulk RFX) é semelhante a troca de campo de registro (RFX).Dados são transferidos automaticamente da fonte de dados para o objeto de conjunto de registros.No entanto, não é possível chamar AddNew, edição, Excluir, or Atualização transferência as alterações de volta para a fonte de dados. De classeCRecordset no momento não fornece um mecanismo para a atualização em massa linhas de dados; no entanto, você pode escrever suas próprias funções utilizando a função de API do ODBC SQLSetPos.

Observe que ClassWizard não oferece suporte a troca de campo de registro em massa; portanto, você deve substituir DoBulkFieldExchange manualmente por gravar chamadas para funções RFX em massa. Para obter mais informações sobre essas funções, consulte o tópico Registro campo Exchange funções.

Para obter mais informações sobre buscar a linha em massa, consulte o artigo conjunto de registros: Buscando os registros em massa (ODBC).Para obter informações relacionadas, consulte o artigo Registro de campo Exchange (RFX).

Exceções

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

Requisitos

Cabeçalho: afxdb.h

Consulte também

Referência

Classe CRecordset

Gráfico de hierarquia

CRecordset::m_nFields

CRecordset::m_nParams

CRecordset::DoFieldExchange

CRecordset::GetFieldValue

Classe CFieldExchange

Outros recursos

CRecordset membros

Registro campo Exchange funções