Freigeben über


CRecordset::SetAbsolutePosition

Positioniert das Recordset auf dem Datensatz entsprechend der angegebenen Datensatznummer.

void SetAbsolutePosition( 
   long nRows  
);

Parameter

  • nRows
    Die einsbasierte Ordnungsposition für den aktuellen Datensatz des Recordsets.

Hinweise

SetAbsolutePosition verschiebt den Zeiger für den aktuellen Datensatz auf Grundlage dieser Ordnungsposition.

Hinweis

Diese Memberfunktion ist in Vorwärts-Recordsets ungültig.

Für ODBC-Recordsets verweist auf eine absolute Positionseinstellung von 1 den ersten Datensatz des Recordsets an; Eine Einstellung von 0 werden die Anfang-vonDatei (BOF)-Speicherort an.

Sie können negative Werte zu SetAbsolutePosition auch übergeben. In diesem Fall wird die Position des Recordsets vom Ende des Recordsets ausgewertet. Beispielsweise SetAbsolutePosition( -1 ) verschiebt den Zeiger für den aktuellen Datensatz auf den letzten Datensatz des Recordsets.

Hinweis

Absolute Position wird nicht, als Ersatzzeichenkombinationen Datensatznummer verwendet werden soll.Lesezeichen sind weiterhin die empfohlene Methode für die Verwaltung und das Zurückgeben zu einer angegebenen Position, da die Position eines Datensatzes ändert, wenn vorherige Datensätze gelöscht werden.Außerdem können Sie nicht gewährleistet werden, dass ein gegebener 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 ORDER BY-Klausel erstellt wird.

Weitere Informationen zur Recordsetnavigation und -Lesezeichen, finden Sie in Artikel Recordset: Scrollen (ODBC) und Recordset: Lesezeichen und absolute Positionen (ODBC).

Ausnahmen

Diese Methode kann Ausnahmen des Typs CDBException* und CMemoryException* auslösen.

Anforderungen

Header: afxdb.h

Siehe auch

Referenz

CRecordset-Klasse

Hierarchiediagramm

CRecordset::SetBookmark