CRecordset::SetRowsetSize

Artigo
02/25/2013

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 .

Observação
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.

Observação
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.

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