CDaoRecordset::GetAbsolutePosition

long GetAbsolutePosition () ;
jeter (CDaoException, CMemoryException);

Valeur de retour

Un entier de 0 au nombre d'enregistrements dans le jeu d'enregistrements. Correspond à la position ordinale de l'enregistrement dans le jeu d'enregistrements.

Remarques

Retourne le numéro de l'enregistrement actuel d'un objet recordset. La valeur de la propriété AbsolutePosition de l'objet sous-jacent de DAO est de base zéro ; un paramètre 0 désigne le premier enregistrement dans le jeu d'enregistrements. Vous pouvez déterminer le nombre d'enregistrements peuplées dans le jeu d'enregistrements en appelant GetRecordCount. En appelant GetRecordCount peut prendre un certain temps car il doit accéder à tous les enregistrements pour déterminer le nombre.

S'il &n'y a aucun enregistrement en cours, comme lorsqu'il n'y a aucun enregistrement dans le jeu d'enregistrements, nbsp ; -1 est retourné. Si l'enregistrement actuel est supprimé, la valeur de la propriété AbsolutePosition n'est pas définie, et MFC lève une exception si elle est référencée. Pour les Jeux d'enregistrements de type feuille de réponse dynamique, nouveaux enregistrements sont ajoutés à la fin de la séquence.

&Notenbsp ;  Cette propriété n'est pas censée être utilisé comme un nombre record de substitution. Signets sont toujours la façon recommandée de conserver et de revenir à une position donnée et la seule façon de la position de l'enregistrement en cours dans tous les types d'objets recordset. En particulier, la position d'un enregistrement donné change lorsque les dossiers qui le précède sont supprimés. Il n'y a également aucune assurance qu'un enregistrement donné aura la position absolue même si le jeu d'enregistrements est recréé à nouveau parce que l'ordre des enregistrements individuels dans un jeu d'enregistrements n'est pas garanti sauf si elle est créée avec une instruction SQL à l'aide d'une clause d'ordrepar .

&Notenbsp ;  Cette fonction membre est valide uniquement pour le type de feuille de réponse dynamique et les Jeux d'enregistrements de type instantané.

Pour plus d'informations sur la recherche de documents, 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é AbsolutePosition » dans l'aide de DAO.

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

Voir aussi  ;CDaoRecordset::SetAbsolutePosition

Index