Compartilhar via


CDaoRecordset::GetRecordCount

Chamar essa função de membro para descobrir quantos registros em um conjunto de registros foram acessados.

long GetRecordCount( );

Valor de retorno

Retorna o número de registros acessados em um objeto do conjunto de registros.

Comentários

GetRecordCount não indica quantos registros estão contidos em um conjunto de registros de dynaset- tipo ou tipo de instantâneo- até que todos os registros são acessados.Esta chamada de função de membro pode ter uma quantidade significativa de tempo para concluir.

O último registro foi acessado uma vez, o valor de retorno indica o número total de registros não canceladas no conjunto de registros.Para forçar o último registro a ser acessado, chame a função de membro de MoveLast ou de FindLast para o conjunto de registros.Você também pode usar uma contagem do SQL para determinar o número de registros próximo ao que sua consulta retornará.

Porque seu aplicativo exclui registros em um conjunto de registros de dynaset- tipo, o valor de retorno de GetRecordCount diminui.Em o entanto, os registros excluídos por outros usuários não são refletidos por GetRecordCount até que o registro atual está localizado em um registro excluído.Se você executar uma transação que afeta a contagem de registro e reverter a transação posteriormente, GetRecordCount não refletirá o número real de registros restantes.

O valor de GetRecordCount de um conjunto de registros de instantâneo- tipo não é afetado por alterações nas tabelas subjacentes.

O valor de GetRecordCount de um conjunto de registros de tipo com reflete o número de registros aproximado na tabela e é afetado imediatamente conforme os registros da tabela são adicionados e excluídos.

Um conjunto de registros sem registros retorna um valor de 0.A o trabalhar com tabelas anexados ou bancos de dados ODBC, GetRecordCount sempre retorna. – 1.Chame a função de membro de Requery em um conjunto de registros redefine o valor de GetRecordCount exatamente como se a consulta foi executada.

Para informações relacionadas, consulte o tópico “propriedade RecordCount” na ajuda de DAO.

Requisitos

Cabeçalho: afxdao.h

Consulte também

Referência

Classe de CDaoRecordset

Gráfico de hierarquia

CDaoRecordset::GetFieldCount

CDaoRecordset::GetFieldInfo

CDaoRecordset::GetIndexCount

CDaoRecordset::GetIndexInfo