AbsolutePage, propriété (ADO)

  • Article

Indique sur quelle page réside l’enregistrement actif.

Paramètres et valeurs de retour

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

Pour du code 64 bits, utilisez un type de données permettant de stocker une valeur 64 bits. Par exemple, vous pouvez utiliser une valeur Long ou une autre valeur pouvant avoir une longueur de 64 bits, comme DBORDINAL. N’utilisez pas de valeurs de PositionEnum, car elles sont limitées à une longueur de 32 bits.

Notes

Cette propriété permet de déterminer le nombre de pages qu’occupe l’enregistrement actuel. Elle utilise la propriété PageSize pour diviser logiquement le nombre total de lignes de l’objet Recordset en une série de pages contenant chacune un nombre d’enregistrements égal à PageSize (à l’exception de la dernière page, qui peut en compter moins). Pour que cette propriété soit disponible, le fournisseur doit prendre en charge la fonctionnalité appropriée.

  • Lors de l’obtention ou de la définition de la propriété AbsolutePage, ADO utilise les propriétés AbsolutePosition et PageSize ensemble comme suit :

  • Pour obtenir la propriété AbsolutePage, ADO commence par récupérer la propriété AbsolutePosition, puis la divise par la propriété PageSize.

  • Pour définir la propriété AbsolutePage, ADO déplace la propriété AbsolutePosition en multipliant la propriété pageSize par la valeur de la nouvelle propriété AbsolutePage, puis ajoute 1 à la valeur. Par conséquent, la position actuelle dans l’objet Recordset après définition de la propriété AbsolutePage est le premier enregistrement dans cette page.

Comme la propriété AbsolutePosition, la propriété AbsolutePage est de base 1, et est égale à 1 quand l’enregistrement actif est le premier enregistrement dans l’objet Recordset. Définissez cette propriété pour passer au premier enregistrement d’une page particulière. Obtenez le nombre total de pages à partir de la propriété PageCount.

S'applique à

Recordset, objet (ADO)

Voir aussi

Exemple des propriétés AbsolutePage, PageCount et PageSize (VB)
Exemple des propriétés AbsolutePage, PageCount et PageSize (VC++)
AbsolutePosition, propriété (ADO)
PageCount, propriété (ADO)
PageSize, propriété (ADO)