CDaoRecordset::SetAbsolutePosition

void SetAbsolutePosition (long lPosition );
jeter (CDaoException, CMemoryException);

Paramètres

lPosition

Correspond à la position ordinale de l'enregistrement dans le jeu d'enregistrements.

Remarques

Définit le nombre record de dossier actuel d'un objet recordset. Appel à SetAbsolutePosition permet de positionner le pointeur d'enregistrement actif à un enregistrement spécifique basé sur sa position ordinale dans un type de feuille de réponse dynamique ou un objet recordset de type instantané. Vous pouvez également déterminer le nombre record actuel en appelant GetAbsolutePosition.

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

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. De définir une valeur supérieure au nombre des causes peuplées d'enregistrements MFC pour lever une exception. Vous pouvez déterminer le nombre d'enregistrements peuplées dans le jeu d'enregistrements en appelant la fonction membre GetRecordCount.

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. 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 prenant en charge les signets. 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 .

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::GetAbsolutePosition

Index