Freigeben über

CRecordset::GetBookmark

  • Artikel

 

Veröffentlicht: Juli 2016

Erhält der Lesezeichenwert für den aktuellen Datensatz.

Syntax

      void GetBookmark( 
   CDBVariant& varBookmark  
);

Parameter

  • varBookmark
    Ein Verweis auf einen CDBVariant-Objekt, das das Lesezeichen im aktuellen Datensatz darstellt.

Hinweise

So bestimmen Sie, ob Lesezeichen auf das Recordset unterstützt werden, CanBookmark Aufruf. Um Lesezeichen bereitzustellen wenn sie unterstützt werden, müssen Sie die CRecordset::useBookmarks Option im dwOptions-Parameter der Memberfunktion Geöffnet festlegen.

Hinweis

Wenn Lesezeichen nicht unterstützt oder nicht verfügbar sind, führt das Aufrufen von GetBookmark eine Ausnahme, die ausgelöst wird.Lesezeichen werden in Vorwärts-Recordsets nicht unterstützt.

GetBookmark weist den Wert des Lesezeichens für den aktuellen Datensatz zu einem CDBVariant-Objekt zu. Um zu diesem Datensatz jederzeit zurückzukehren nachdem Sie zu einem anderen Datensatz verschoben haben, rufen Sie SetBookmark mit dem entsprechenden CDBVariant-Objekt auf.

Hinweis

Nach bestimmten Recordset-Operationen Lesezeichen sind möglicherweise nicht mehr gültig.Wenn Sie beispielsweise GetBookmark gefolgt von Requery aufrufen, sind Sie möglicherweise nicht in der Lage, den Datensatz mit SetBookmark zurückzukehren.Rufen Sie CDatabase::GetBookmarkPersistence auf, um sicherzustellen, dass Sie SetBookmark sicher aufrufen können.

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

Ausnahmen

Exception

Condition

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

Anforderungen

Header: afxdb.h

Siehe auch

CRecordset Class
Hierarchiediagramm
CRecordset::CanBookmark
CRecordset::SetBookmark
CDatabase::GetBookmarkPersistence