CDaoRecordset::GetRecordCount

getRecordCount long (de) ;
jeter (CDaoException, CMemoryException);

Valeur de retour

Renvoie le nombre d'enregistrements dans un objet recordset.

Remarques

Appelez cette fonction membre pour connaître le nombre d'enregistrements dans un jeu d'enregistrements ont été consulté. GetRecordCount n'indique pas le nombre d'enregistrements est contenu dans un type de feuille de réponse dynamique ou un objet recordset de type instantané, jusqu'à ce que tous les enregistrements ont été consultés. Cet appel de fonction membre peut prendre énormément de temps pour terminer.

Une fois le dernier dossier a été consulté, la valeur de retour indique le nombre total d'enregistrements non supprimées dans le jeu d'enregistrements. Pour forcer le dernier enregistrement d'être accessibles, appelez la fonction membre MoveLast ou FindLast pour le jeu d'enregistrements. Vous pouvez également utiliser un compte SQL afin de déterminer le nombre approximatif de votre requête retourne des enregistrements.

À mesure que votre application supprime les enregistrements dans un jeu d'enregistrements de type feuille de réponse dynamique, la valeur de retour de GetRecordCount diminue. Cependant, les enregistrements supprimés par d'autres utilisateurs ne sont pas reflétées par GetRecordCount jusqu'à ce que l'enregistrement actuel est positionné à un enregistrement supprimé. Si vous exécutez une opération qui affecte le nombre record et ensuite restaurer la transaction, GetRecordCount ne reflétera pas le nombre réel d'enregistrements restants.

GetRecordCount la valeur d'un objet recordset de type instantané n'est pas affectée par les changements dans les tables sous-jacentes.

La valeur d'un objet recordset de type table GetRecordCount reflète le nombre approximatif d'enregistrements de la table et est affectée immédiatement sous enregistrements sont ajoutés et supprimés de la table.

U&n jeu d'enregistrements avec aucune mention renvoie une valeur de 0. Quand travailler avec joint tables ou bases de données ODBC, GetRecordCount toujours returnsnbsp ; – 1. Appeler la fonction membre Requery sur un jeu d'enregistrements réinitialise la valeur de GetRecordCount comme si la requête ont resigné.

Pour plus d'informations sur la navigation dans les Jeux d'enregistrements, consultez l'article jeu d'enregistrements DAO : Navigation de jeu d'enregistrements dans le Guide du programmeur Visual C++. Pour plus d'informations, consultez la rubrique « Propriété RecordCount » dans l'aide de DAO.

Aperçu de CDaoRecordset |  ; Membres de la classe | Graphique de la hiérarchie

Voir aussi  ;CDaoRecordset::GetFieldCount, CDaoRecordset::GetFieldInfo, CDaoRecordset::GetIndexCount, CDaoRecordset::GetIndexInfo

Index