AbsolutePosition, propriété (ADO)
Indique la position ordinale d’un jeu d’enregistrements 'enregistrement actif de l’objet.
Paramètres et valeurs de retour
Pour le code 32 bits, définit ou renvoie une valeur Long comprise entre 1 et le nombre d’enregistrements dans l’objet Recordset (RecordCount), ou retourne l’une des valeurs PositionEnum.
Pour le code 64 bits, utilisez un type de données qui fournit un stockage d’une valeur 64 bits. Par exemple, vous pouvez utiliser une valeur long ou une autre valeur de longueur 64 bits telle que DBORDINAL. N’utilisez pas valeurs positionEnum car elles sont limitées à la longueur 32 bits.
Remarques
Pour définir la propriété AbsolutePosition, ADO exige que le fournisseur OLE DB que vous utilisez implémente l’interface IRowsetLocate :IRowset.
L’accès à la propriété AbsolutePosition d’un jeu d’enregistrements ouvert avec un curseur avant uniquement ou dynamique déclenche l’erreur adErrFeatureNotAvailable. Avec d’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 passer à 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 de 1 et est égal à 1 lorsque l’enregistrement actif est le premier enregistrement du jeu d’enregistrements . 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 à partir de l’enregistrement que vous avez spécifié. La propriété CacheSize détermine la taille de ce groupe.
Note
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 non plus d’assurance qu’un enregistrement donné aura le même AbsolutePosition si l’objet Recordset est réexécuté ou rouvert. Les signets sont toujours la façon recommandée de conserver et de revenir à une position donnée et sont le seul moyen de positionner tous les types d’objet Recordset Recordset.
S’applique à
Voir aussi
AbsolutePosition et CursorLocation, propriétés - Exemple (VB)
AbsolutePosition et CursorLocation, propriétés - Exemple (VC++)
AbsolutePage, propriété (ADO)
RecordCount, propriété (ADO)