Propriedade RecordCount (ADO)

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

Valor Retornado

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

Comentários

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

Indicadores ou posicionamento aproximado

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

Por outro lado, se o objeto Recordset não der suporte a indicadores ou ao posicionamento aproximado, o acesso a essa propriedade poderá causar um esgotamento significativo dos recursos. O esgotamento ocorre porque todos os registros precisam ser recuperados e contados para que um valor preciso de RecordCount seja retornado.

• adBookmark está relacionado aos indicadores.
• adApproxPosition está relacionado ao posicionamento aproximado.

Observação

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

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

Aplica-se A

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)