CRecordset::SetRowsetSize

Artigo
08/25/2010

Especifica o número de registros que deseja recuperar durante uma busca.

virtual void SetRowsetSize(
   DWORD dwNewRowsetSize 
);

Parâmetros

dwNewRowsetSize
O número de linhas a serem recuperadas durante uma determinado busca.

Comentários

Esta função de membro virtual Especifica quantas linhas você deseja recuperar durante uma única busca ao usar a busca de linha em massa.Para implementar a busca de linha em massa, você deve conjunto o CRecordset::useMultiRowFetch opção da dwOptions parâmetro das em abertofunção de membro .

Observação:
Chamada SetRowsetSize sem implementar em massa linha buscando resultará em uma declaração com falha.

De telefonarSetRowsetSize antes de ligar em aberto definir inicialmente o dimensionar do conjunto de linhas para o conjunto de registros.O dimensionar do conjunto de linhas padrão durante a implementação de busca de linha em massa é 25.

Observação:
Tenha cuidado ao chamar SetRowsetSize.Se manualmente são alocar o armazenamento de dados (sistema autônomo especificado pelo CRecordset::userAllocMultiRowBuffers opção do parâmetro dwOptions no em aberto), você deve verificar se é necessário realocar esses buffers de armazenamento depois que você telefonar SetRowsetSize, mas antes de executar qualquer operação de navegação do cursor.

Tenha cuidado ao chamar SetRowsetSize.Se manualmente são alocar o armazenamento de dados (sistema autônomo especificado pelo CRecordset::userAllocMultiRowBuffers opção do parâmetro dwOptions no em aberto), você deve verificar se é necessário realocar esses buffers de armazenamento depois que você telefonar SetRowsetSize, mas antes de executar qualquer operação de navegação do cursor.

Para obter a configuração corrente para o dimensionar do conjunto de linhas, ligue para GetRowsetSize.

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