AbsolutePosition-Eigenschaft (ADO)

Gilt für: Access 2013, Office 2013

Gibt die Position des aktuellen Datensatzes eines Recordset-Objekts an.

Einstellungen und Rückgabewerte

Mit dieser Eigenschaft wird ein Wert vom Datentyp Long zwischen 1 und der Anzahl von Datensätzen im Recordset-Objekt (RecordCount) zurückgegeben oder festgelegt, oder es wird einer der Werte von PositionEnum zurückgegeben.

Hinweise

Zum Festlegen der AbsolutePosition-Eigenschaft erfordert ADO, dass der von Ihnen verwendete OLE DB-Anbieter die IRowsetLocate-Schnittstelle implementiert.

Accessing the AbsolutePosition property of a Recordset that was opened with either a forward-only or dynamic cursor raises the error adErrFeatureNotAvailable. With other cursor types, the correct position will be returned as long as the provider supports the IRowsetScroll interface. Wenn der Anbieter die IRowsetScroll-Schnittstelle nicht unterstützt, wird die Eigenschaft auf adPosUnknown festgelegt. In der Dokumentation ihres Anbieters erfahren Sie, ob er IRowsetScroll unterstützt.

Verwenden Sie die AbsolutePosition -Eigenschaft, um zu einem Datensatz entsprechend der Ordnungsposition zu navigieren, die er im Recordset -Objekt einnimmt, oder um die Ordnungsposition des aktuellen Datensatzes zu ermitteln. Die entsprechende Funktionalität muss vom Anbieter unterstützt werden, damit diese Eigenschaft verfügbar ist.

AbsolutePosition ist wie die AbsolutePage -Eigenschaft 1-basiert und entspricht 1, wenn der aktuelle Datensatz der erste Datensatz im Recordset -Objekt ist. Sie können die Gesamtanzahl von Datensätzen im Recordset-Objekt mit der RecordCount-Eigenschaft abrufen.

Wenn Sie die AbsolutePosition-Eigenschaft 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 von Ihnen angegebenen Datensatz. Die CacheSize-Eigenschaft bestimmt die Größe dieser Gruppe.

Hinweis

Sie sollten die AbsolutePosition-Eigenschaft nicht als Ersatz-Datensatznummer verwenden. Die Position eines Datensatzes wird geändert, wenn Sie einen vorausgehenden Datensatz löschen. Außerdem gibt es keine Gewähr, dass ein bestimmter Datensatz den gleichen Wert für AbsolutePosition aufweist, wenn das Recordset-Objekt erneut abgefragt oder geöffnet wird. Lesezeichen sind immer noch die empfohlene Methode, um eine bestimmte Position beizubehalten und zu einer bestimmten Position zurückzukehren, und sind die einzige Möglichkeit, um alle Typen von Recordset-Objekten zu positionieren.