Compartilhar via


CRecordset::SetRowsetSize

Especifica o número de registros que você deseja recuperar durante um esforço.

virtual void SetRowsetSize( 
   DWORD dwNewRowsetSize  
);

Parâmetros

  • dwNewRowsetSize
    O número de linhas para recuperar em um esforço dado.

Comentários

Essa função de membro virtual especifica quantas linhas você deseja recuperar durante um único esforço ao usar buscar em massa da linha. Para implementar a linha em massa que pesquisa, você deve definir a opção de CRecordset::useMultiRowFetch no parâmetro de dwOptions da função de membro de Abrir .

Dica

A chamada SetRowsetSize sem implementar buscar em massa de linha resultará em uma declaração falha.

Chamada SetRowsetSize antes de chamar Abrir inicialmente para definir o tamanho de rowset para o conjunto de registros. O tamanho padrão de rowset ao implementar buscar em massa de linha é 25.

Dica

Use cuidados ao chamar SetRowsetSize.Se você está designando manualmente o armazenamento de dados (como especificado pelo padrão de CRecordset::userAllocMultiRowBuffers de parâmetro de dwOptions em Abrir), você deve verificar se você precisa realocar esses buffers de armazenamento depois de você chamar SetRowsetSize, mas antes de executar qualquer operação de navegação do cursor.

Para obter a configuração atual para o tamanho de rowset, chame GetRowsetSize.

Para obter mais informações sobre a linha em massa que pesquisa, consulte o artigo conjunto de registros: Para buscar registros em massa (ODBC).

Requisitos

Cabeçalho: afxdb.h

Consulte também

Referência

Classe CRecordset

Gráfico da hierarquia

CRecordset::Open

CRecordset::GetRowsetSize

CRecordset::CheckRowsetError

CRecordset::DoBulkFieldExchange