Partager via

AbsolutePosition, propriété (ADO)

  • Article

S’applique à : Access 2013, Office 2013

Indique la position ordinale de l’enregistrement actif de l’objet Recordset.

Paramètres et valeurs de retour

Définit ou renvoie une valeur de type Long comprise entre 1 et le nombre d’enregistrements dans l’objet Recordset (RecordCount), ou renvoie l’une des valeurs de PositionEnum.

Remarques

Pour définir la propriété AbsolutePosition , ADO exige que le fournisseur OLE DB que vous utilisez implémente l’interface IRowsetLocate.

L'accès à la propriété AbsolutePosition d'un objet Recordset ouvert avec un curseur dynamique ou avant uniquement génère une erreur adErrFeatureNotAvailable. Avec les autres types de curseur, la position correcte est retournée pour autant que le fournisseur prenne en charge l'interface IRowsetScroll. Si le fournisseur ne prend pas en charge l'interface IRowsetScroll, la propriété est définie sur adPosUnknown. Reportez-vous à la documentation pour déterminer si l'interface IRowsetScroll est prise en charge.

La propriété AbsolutePosition permet d'accéder à un enregistrement donné, en fonction de sa position ordinale dans l'objet Recordset ou de déterminer la position ordinale de l'enregistrement actif. Le fournisseur doit prendre en charge les fonctionnalités requises pour que cette propriété soit disponible.

Comme la propriété AbsolutePage, la propriété AbsolutePosition est en base 1 et est égale à 1 lorsque l'enregistrement actif est le premier enregistrement de l'objet Recordset. Vous pouvez obtenir le nombre total d’enregistrements dans l’objet Recordset à partir de la propriété RecordCount.

Lorsque vous définissez la propriété AbsolutePosition , même s’il s’agit d’un enregistrement dans le cache actif, ADO recharge le cache avec un nouveau groupe d’enregistrements commençant par l’enregistrement que vous avez spécifié. La propriété CacheSize détermine la taille de ce groupe.

Remarque

Vous ne devez pas utiliser la propriété AbsolutePosition comme numéro d'enregistrement de substitution. La position d'un enregistrement donné change lorsque vous supprimez un enregistrement précédent. Rien ne garantit qu'un enregistrement donné possédera la même valeur AbsolutePosition si l'objet Recordset est actualisé ou rouvert. Les signets sont toujours le moyen recommandé de conserver et de revenir à une position donnée, et constituent le seul moyen de positionner tous les types d’objets Recordset .