AbsolutePosition, propriété (ADO)

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

Paramètres et valeurs de retour

Pour le code 32 bits, définit ou retourne une valeur Long comprise entre 1 et le nombre d’enregistrements de l’objet Recordset (RecordCount) ou retourne l’une des valeurs PositionEnum.

Pour le code 64 bits, utilisez un type de données qui fournit le stockage d’une valeur 64 bits. Par exemple, vous pouvez utiliser une valeur Long ou une autre valeur de longueur 64 bits, comme DBORDINAL. N’utilisez pas de valeurs PositionEnum, car elles sont limitées à une longueur de 32 bits.

Notes

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

L’accès à la propriété AbsolutePosition d’un Recordset ouvert avec un curseur avant uniquement ou dynamique déclenche l’erreur adErrFeatureNotAvailable. Avec les autres types de curseurs, la position correcte est retournée tant que le fournisseur OLE DB prend en charge l’interface IRowsetScroll:IRowsetLocate. Si le fournisseur ne prend pas en charge l’interface IRowsetScroll, la propriété est définie sur adPosUnknown. Consultez la documentation de votre fournisseur pour déterminer s’il prend en charge IRowsetScroll.

Utilisez la propriété AbsolutePosition pour accéder à un enregistrement en fonction de sa position ordinale dans l’objet Recordset ou pour déterminer la position ordinale de l’enregistrement actif. Le fournisseur doit prendre en charge les fonctionnalités appropriées pour que cette propriété soit disponible.

Comme la propriété AbsolutePage, AbsolutePosition est basée sur 1 et est égale à 1 lorsque l’enregistrement actif est le premier enregistrement dans 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.

Notes

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. Il n’y a pas d’assurance qu’un enregistrement donné aura la même AbsolutePosition si l’objet Recordset fait l’objet d’une nouvelle requête ou est rouvert. Les signets sont toujours le moyen recommandé de conserver et de revenir à une position donnée et sont le seul moyen de positionner tous les types d’objets Recordset.

S'applique à

Recordset, objet (ADO)

Voir aussi

AbsolutePosition et CursorLocation, exemple (VB)
AbsolutePosition et CursorLocation, exemple (VC++)
AbsolutePage, propriété (ADO)
RecordCount, propriété (ADO)