CDaoRecordset::GetRecordCount
Appelez la fonction membre pour déterminer le nombre d'enregistrements dans un recordset ont été accessibles.
long GetRecordCount( );
Valeur de retour
Retourne le nombre d'enregistrements accessibles dans un objet recordset.
Notes
GetRecordCount n'indique pas le nombre d'enregistrements sont contenus dans un recordset de type feuille de réponse dynamique ou de type instantané jusqu'à ce que tous les enregistrements ont été accessibles. Cet appel d'une fonction membre peut prendre une quantité de temps soit terminée.
Une fois le dernier enregistrement a été demandé, la valeur de retour indique le nombre total d'enregistrements repris dans le recordset. Pour forcer le dernier enregistrement à faire référence, appelez la fonction membre d' MoveLast ou d' FindLast pour le recordset. Vous pouvez également utiliser un nombre SQL pour déterminer le nombre d'enregistrements approximatif que votre requête retourne.
Lorsque votre application supprime des enregistrements dans un recordset de type feuille de réponse dynamique, la valeur de retour d' GetRecordCount diminue. Toutefois, les enregistrements supprimés par d'autres utilisateurs ne sont pas reflétés par GetRecordCount jusqu'à ce que l'enregistrement en cours est positionné sur un enregistrement supprimé. Si vous exécutez une transaction qui affecte le nombre d'enregistrements et restaurer ultérieurement arrière la transaction, GetRecordCount reflétera ne pas le nombre réel d'enregistrements restants.
La valeur d' GetRecordCount d'un recordset de type instantané n'est pas affectée par les modifications dans les tables sous-jacentes.
La valeur d' GetRecordCount d'un recordset de type table indique le nombre d'enregistrements approximatif dans la table et est affectée immédiatement lorsque des enregistrements de la table sont ajoutés ou supprimés.
Un recordset sans les enregistrements retourne une valeur de 0. Lorsque vous utilisez des tables ou des bases de données ODBC liés, GetRecordCount retourne toujours – 1. Appeler la fonction membre de Requery sur un recordset réinitialise la valeur d' GetRecordCount comme si la requête exécutées à nouveau.
Pour des informations connexes, consultez la rubrique « propriété de RecordCount » dans l'aide de DAO.
Configuration requise
Header: afxdao.h