void SetBookm&ark (const CDBVariantamp; varBookmark );
Werfen Sie (CDBException, CMemoryException);
Parameter
varBookmark
Ein Verweis auf ein CDBVariant -Objekt mit dem Lesezeichenwert für einen bestimmten Datensatz.
Bemerkungen
Rufen Sie diese Memberfunktion um das Recordset auf den Datensatz mit dem angegebene Lesezeichen zu positionieren. Rufen Sie zum bestimmen, ob Lesezeichen, für das Recordset unterstützt werden, CanBookmark. Wenn Lesezeichen verfügbar wenn sie unterstützt werden, müssen Sie die CRecordset::useBookmarks -Option im Parameter DwOptions der Open -Memberfunktion festlegen.
Hinweis&Nbsp; Wenn Lesezeichen nicht unterstützte oder nicht verfügbar sind, führt SetBookmark aufrufen eine Ausnahme. Lesezeichen werden in vorwärts-Recordsets nicht unterstützt.
Zum ersten Abrufen des Lesezeichens für den aktuellen Datensatz rufen Sie GetBookmark, die den Textmarke Wert auf ein CDBVariant -Objekt speichert. Später können Sie mit diesem Datensatz zurückgeben durch Aufruf der SetBookmark mithilfe des gespeicherten Lesezeichen Werts.
Hinweis&Nbsp; Nach bestimmten Recordset-Operationen prüfen Sie die Lesezeichen-Persistenz vor dem Aufruf der SetBookmark. Beispielsweise wenn Sie ein Lesezeichen mit GetBookmark abrufen und dann Requeryaufrufen, kann das Lesezeichen nicht mehr gültig sein. Rufen Sie CDatabase::GetBookmarkPersistence zu überprüfen, ob Sie SetBookmark sicher aufrufen können.
Weitere Informationen zu Lesezeichen und Recordsetnavigation finden Sie unter Artikel Recordset: Lesezeichen und Absolute Positionen (ODBC) und Recordset: Scrollen (ODBC) im Visual C++ Programmer's Guide.
CRecordset Übersicht | Member der Klasse | Hierarchiediagramm
Siehe auch&Nbsp;CRecordset:: CanBookmark aufrufen, CRecordset::GetBookmark, CRecordset::SetAbsolutePosition, CDatabase::GetBookmarkPersistence