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
Consulte Também
Exemplo das propriedades Filter e RecordCount (VB)
Exemplo das propriedades Filter e RecordCount (VC+++)
Propriedade AbsolutePosition (ADO)
Propriedade PageCount (ADO)