Partager via


CDaoRecordset::GetAbsolutePosition

Retourne le nombre d'enregistrement de l'enregistrement actuel d'un objet recordset.

long GetAbsolutePosition( );

Valeur de retour

Un entier de 0 au nombre d'enregistrements du recordset. Correspond à la position ordinale de l'enregistrement en cours dans le recordset.

Notes

La valeur de propriété d'AbsolutePosition de l'objet DAO sous-jacent est zéro ; une configuration de 0 fait référence au premier enregistrement du recordset. Vous pouvez déterminer le nombre d'enregistrements remplis dans le recordset en appelant GetRecordCount. Appeler GetRecordCount peut prendre un certain temps parce qu'il doit accéder à tous les enregistrements pour déterminer le nombre.

S'il n'existe aucun enregistrement actif, comme lorsqu'il n'y a aucun enregistrement du recordset, – 1 est retourné. Si l'enregistrement en cours est supprimé, la valeur de propriété d'AbsolutePosition n'est pas définie, et jet MFC une exception si elle est référencée. Pour les recordsets de type feuille de réponse dynamique, de nouveaux enregistrements sont ajoutés à la fin de la séquence.

Notes

Cette propriété n'est pas destinée à être utilisée comme numéro d'enregistrement de remplacement.Les signets sont toujours la méthode recommandée pour conserver et de revenir à une position donnée et sont la seule façon de positionner l'enregistrement courant pour tous les types d'objets recordset.En particulier, la position d'un enregistrement donné change lorsque les archivages précédant le sont supprimés.Il n'y a également aucune assurance qu'un enregistrement donné aura la même position absolue si le recordset est recréé de nouveau parce que l'ordre des enregistrements dans un recordset n'est pas garanti à moins qu'elle ne soit créée avec une instruction SQL à l'aide d'une clause d' ORDERBY .

Notes

Cette fonction membre est valide uniquement pour les recordsets de type feuille de réponse dynamique et de type instantané.

Pour des informations connexes, consultez la rubrique « propriété d'AbsolutePosition » dans l'aide de DAO.

Configuration requise

Header: afxdao.h

Voir aussi

Référence

CDaoRecordset, classe

Graphique de la hiérarchie

CDaoRecordset::SetAbsolutePosition