Freigeben über


AbsolutePosition-Eigenschaft (ADO)

Gibt die ordinale Position des aktuellen Recordset-Objektes an.

Einstellungen und Rückgabewerte

Für 32-Bit-Code: Legt einen Long-Wert zwischen 1 und der Anzahl der im Recordset-Objekt enthaltenen Datensätze (RecordCount) 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

Um die Eigenschaft AbsolutePosition festzulegen, erfordert ADO, dass der OLE DB-Anbieter, den Sie verwenden, die SchnittstelleIRowsetLocate:IRowset implementieren.

Der Zugriff auf die Eigenschaft AbsolutePosition eines Recordset, das entweder mit einem Nur-Vorwärts- oder einem dynamischen Cursor geöffnet wurde, führt zu dem Fehler adErrFeatureNotAvailable. Bei anderen Cursor-Typen wird die richtige Position zurückgegeben, sofern der OLE DB-Anbieter die Schnittstelle IRowsetScroll:IRowsetLocate unterstützt. Wenn der Anbieter die Schnittstelle IRowsetScroll nicht unterstützt, wird die Eigenschaft auf adPosUnknown gesetzt. Sehen Sie in der Dokumentation Ihres Anbieters nach, ob er IRowsetScroll unterstützt.

Verwenden Sie die Eigenschaft AbsolutePosition, um auf der Grundlage ihrer Ordnungsposition im Recordset-Objekt zu einem Datensatz zu wechseln, oder um die Ordnungsposition des aktuellen Datensatzes zu bestimmen. Der Anbieter muss die entsprechende Funktionalität unterstützen, damit diese Eigenschaft zur Verfügung steht.

Ebenso wie die Eigenschaft AbsolutePage ist AbsolutePosition 1-basiert und hat den Wert 1, wenn der aktuelle Datensatz der erste Datensatz im Recordset ist. Die Gesamtanzahl der Datensätze im Recordset-Objekt können Sie über die Eigenschaft RecordCount abfragen.

Wenn Sie die Eigenschaft AbsolutePosition festlegen, auch wenn es sich um einen Datensatz im aktuellen Cache handelt, lädt ADO den Cache mit einer neuen Gruppe von Datensätzen neu, beginnend mit dem angegebenen Datensatz. Die Eigenschaft CacheSize bestimmt die Größe dieser Gruppe.

Hinweis

Die Eigenschaft AbsolutePosition sollten Sie nicht als Ersatz für eine Datensatznummer verwenden. Die Position eines bestimmten Datensatzes ändert sich, wenn Sie einen vorherigen Datensatz löschen. Es ist auch nicht gewährleistet, dass ein bestimmter Datensatz die gleiche AbsolutePosition hat, wenn das Recordset-Objekt erneut abgefragt oder geöffnet wird. Lesezeichen sind nach wie vor die bevorzugte Methode, um eine bestimmte Position festzuhalten und zu ihr zurückzukehren. Sie sind die einzige Möglichkeit, die Positionierung über alle Arten von Recordset-Objekten hinweg vorzunehmen.

Gilt für

Recordset-Objekt (ADO)

Weitere Informationen

Beispiel für die Eigenschaften AbsolutePosition und CursorLocation (VB)
Beispiel für die Eigenschaften AbsolutePosition und CursorLocation (VC++)
AbsolutePage-Eigenschaft (ADO)
RecordCount-Eigenschaft (ADO)