CRecordset::SetBookmark

Artikel
02/26/2013

Positioniert das Recordset auf dem Datensatz, der das angegebene Lesezeichen enthält.

void SetBookmark( 
   const CDBVariant& varBookmark  
);

Parameter

varBookmark
Ein Verweis auf einen CDBVariant-Objekt, das den Lesezeichenwert für einen bestimmten Datensatz enthält.

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 SetBookmark eine Ausnahme, die ausgelöst wird.Lesezeichen werden in Vorwärts-Recordsets nicht unterstützt.

So rufen Sie zuerst das Lesezeichen für den aktuellen Datensatz, Aufruf GetBookmark ab, der den Lesezeichenwert zu einem CDBVariant-Objekt gespeichert werden.Später können Sie zu diesem Datensatz zurückkehren, indem Sie SetBookmark mithilfe des gespeicherten Lesezeichenwerts aufrufen.

Hinweis
Nach bestimmten Recordset-Operationen sollten Sie die Lesezeichenpersistenz überprüfen, bevor Sie SetBookmark aufrufen.Wenn Sie beispielsweise ein Lesezeichen mit GetBookmark abrufen und dann Requery aufrufen, kann das Lesezeichen nicht mehr gültig.Rufen Sie CDatabase::GetBookmarkPersistence auf, um sicherzustellen, dass Sie SetBookmark sicher aufrufen können.