Freigeben über


CDaoRecordset::GetAbsolutePosition

Gibt die Datensatznummer des aktuellen Datensatzes eines Recordset-Objekts zurück.

long GetAbsolutePosition( );

Rückgabewert

Eine ganze Zahl von 0 bis zur Anzahl von Datensätzen im Recordset.Entspricht der Ordnungsposition des aktuellen Datensatzes im Recordset.

Hinweise

Der AbsolutePositions-Eigenschaftswert des zugrunde liegenden DAO-Objekts ist nullbasiert; Eine Einstellung von 0 auf den ersten Datensatz des Recordsets an.Sie können die Anzahl der aufgefüllten Datensätze im Recordset bestimmen, indem Sie GetRecordCount aufrufen.Das Aufrufen von GetRecordCount akzeptiert möglicherweise einige Zeit, da sie für alle Datensätze zugreifen muss, um die Anzahl zu bestimmen.

Wenn es keinen aktuellen Datensatz gibt, wie, wenn keine Datensätze im Recordset gibt, - 1 wird zurückgegeben.Wenn der aktuelle Datensatz gelöscht wird, wird der AbsolutePositions-Eigenschaftswert nicht definiert, und MFC löst eine Ausnahme aus, wenn verwiesen wird.Für Recordsets vom Typ Dynaset werden neue Datensätze an das Ende der Sequenz hinzugefügt.

HinweisHinweis

Diese Eigenschaft ist nicht vorgesehen, als Ersatzzeichenkombinationen Datensatznummer verwendet werden.Lesezeichen sind weiterhin die empfohlene Methode für die Verwaltung und das Zurückgeben zu einer angegebenen Position und sind die einzige Möglichkeit, den aktuellen Datensatz zu allen Typen Recordset-Objekte zu positionieren.Insbesondere ändert die Position eines angegebenen Datensatzes, wenn die Datensätze, die ihm vorausgehen, gelöscht werden.Es gibt auch keine sicher, der ein angegebener Datensatz dieselbe absolute Position verfügt, wenn das Recordset neu erstellt wird, weil die Reihenfolge der einzelnen Datensätze innerhalb eines Recordsets nicht garantiert wird, es sei denn, sie mit einer SQL-Anweisung mit einer Klausel ORDERBY erstellt wird.

HinweisHinweis

Diese Memberfunktion ist nur für und die Recordsets vom Typ Dynaset vom Typ Momentaufnahme gültig.

Weitere Informationen finden Sie im Thema "AbsolutePositions-Eigenschaft" in der DAO-Hilfe.

Anforderungen

Header: afxdao.h

Siehe auch

Referenz

CDaoRecordset-Klasse

Hierarchien-Diagramm

CDaoRecordset::SetAbsolutePosition