CDaoRecordset::GetRecordCount

longo (GetRecordCount);
lançar (CDaoException, CMemoryException);

Valor de retorno

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

Observações

Chame esta função membro para localizar out quantos registros em um recordset tenham sido acessados. GetRecordCount não indica quantos registros estão contidos em um tipo dynaset ou um recordset do tipo snapshot até que todos os registros tenham sido acessados. Chamar essa função de membro pode levar uma quantidade significativa de tempo para concluir.

Depois que o último registro foi acessado, o valor de retorno indica o número total de registros recuperados do conjunto de registros. Para forçar o último registro a serem acessados, chame a função de membro MoveLast ou FindLast para o conjunto de registros. Você também pode usar uma contagem de SQL para determinar o número aproximado de registros que a consulta retornará.

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

O valor de GetRecordCount de um conjunto de registros do tipo snapshot não é afetado pelas alterações nas tabelas subjacentes.

O valor de GetRecordCount de um conjunto de registros do tipo table reflete o número aproximado de registros na tabela e é afetado imediatamente como tabela registros são adicionados e excluídos.

Um co&njunto de registros com registros não retorna um valor de 0. Quando trabalho com anexado tabelas ou bancos de dados ODBC, GetRecordCount sempre returnsnbsp; – 1. Chamar a função de membro RepetirConsulta em um recordset redefine o valor de GetRecordCount como se a consulta foram re-executed.

Para obter mais informações sobre como navegar em conjuntos de registros, consulte o artigo DAO Recordset: navegação do conjunto de registros no Guia do programador do Visual C++. Para obter informações relacionadas, consulte o tópico "Propriedade RecordCount" na Ajuda do DAO.

Visão geral de CDaoRecordsetMembros de classe | Gráfico de hierarquia

Co&nsulte tambémnbsp;CDaoRecordset::GetFieldCount, CDaoRecordset::GetFieldInfo, CDaoRecordset::GetIndexCount, CDaoRecordset::GetIndexInfo

Index