Partilhar via

Propriedade RecordCount (ADO)

  • Artigo

Indica o número de registros em um objeto Recordset.

Valor retornado

Retorna um valor de Long que indica o número de registros no conjunto de registros .

Observações

Use a propriedade RecordCount para descobrir quantos registros estão em um objeto Recordset. A propriedade retorna -1 quando o ADO não pode determinar o número de registros ou se o provedor ou o tipo de cursor não dá suporte RecordCount. Ler a propriedade RecordCount em uma do Recordset fechada causa um erro.

Indicadores ou posicionamento aproximado

Se o objeto Recordset oferecer suporte a indicadores ou posicionamento aproximado, essa propriedade retornará o número exato de registros no Recordset. Essa propriedade retorna o número exato, independentemente de o Conjunto de Registros ter sido totalmente preenchido.

Por outro lado, se o objeto Recordset não dar suporte a indicadores ou posicionamento aproximado, acessar essa propriedade pode ser um dreno significativo nos recursos. O dreno ocorre porque todos os registros devem ser recuperados e contados para retornar um valor recordcount preciso.

  • adBookmark relacionados a indicadores.
  • adApproxPosition está relacionado ao posicionamento aproximado.

Nota

Nas versões do ADO 2.8 e anteriores, o provedor SQLOLEDB busca todos os registros quando um cursor do lado do servidor é usado, apesar de retornar True para suportes (adApproxPosition) e Supports (adBookmark).

O tipo de cursor do objeto Recordset afeta se o número de registros pode ser determinado. A propriedade RecordCount retornará -1 para um cursor somente para encaminhamento; a contagem real para um cursor estático ou de conjunto de chaves; e -1 ou a contagem real de um cursor dinâmico, dependendo da fonte de dados.

Aplica-se a

do objeto Recordset (ADO)

Consulte Também

Exemplo das propriedades Filter e RecordCount (VB)
Exemplo das propriedades Filter e RecordCount (VC++)
propriedade AbsolutePosition (ADO)
propriedade PageCount (ADO)