AbsolutePage-Eigenschaft (ADO)

Gibt an, auf welcher Seite sich der aktuelle Datensatz befindet.

Einstellungen und Rückgabewerte

Für 32-Bit-Code: Legt einen Long-Wert zwischen 1 und der Anzahl der im Recordset-Objekt enthaltenen Seiten (PageCount) fest oder gibt einen der PositionEnum-Werte zurück.

Für 64-Bit-Code verwenden Sie einen Datentyp, der die Speicherung eines 64-Bit-Wertes ermöglicht. Sie können zum Beispiel entweder Long oder einen anderen Wert mit einer Länge von 64 Bit wie DBORDINAL verwenden. Verwenden Sie PositionEnum-Werte nicht, da sie auf 32-Bit-Länge beschränkt sind.

Bemerkungen

Mit dieser Eigenschaft kann die Seitenzahl bestimmt werden, auf der sich der aktuelle Datensatz befindet. Sie verwendet die PageSize-Eigenschaft, um die Gesamtanzahl der Zeilen des Recordset-Objekts in eine Reihe von Seiten zu teilen, von denen jede die Anzahl der Datensätze aufweist, die der PageSize entsprechen (außer für die letzte Seite, die möglicherweise weniger Datensätze aufweist). Der Anbieter muss die entsprechende Funktionalität unterstützen, damit diese Eigenschaft zur Verfügung steht.

  • Beim Abrufen oder Festlegen der AbsolutePage-Eigenschaft verwendet ADO die AbsolutePosition-Eigenschaft und die PageSize-Eigenschaft wie folgt:

  • Um die AbsolutePage abzurufen, ruft ADO zuerst AbsolutePosition ab und teilt sie dann durch PageSize.

  • Um AbsolutePage festzulegen, verschiebt ADO AbsolutePosition wie folgt: Es multipliziert PageSize mit dem neuen AbsolutePage-Wert und fügt dann 1 zum Wert hinzu. Daher ist die aktuelle Position im Recordset nach dem erfolgreichen Festlegen von AbsolutePage der erste Datensatz auf dieser Seite.

Ebenso wie die Eigenschaft AbsolutePosition ist AbsolutePage 1-basiert und hat den Wert 1, wenn der aktuelle Datensatz der erste Datensatz im Recordset ist. Legen Sie diese Eigenschaft fest, um zum ersten Datensatz einer bestimmten Seite zu wechseln. Die Gesamtzahl der Seiten bestimmen Sie anhand der PageCount-Eigenschaft.

Gilt für

Recordset-Objekt (ADO)

Weitere Informationen

Die Eigenschaften AbsolutePage, PageCount und PageSize (Beispiel) (VB)
Die Eigenschaften AbsolutePage, PageCount und PageSize (Beispiel) (VC++)
AbsolutePosition-Eigenschaft (ADO)
PageCount-Eigenschaft (ADO)
PageSize-Eigenschaft (ADO)