Udostępnij za pośrednictwem

CRecordset::SetBookmark

  • Artykuł

 

Pozycje zestawu rekordów do rekordu zawierającego zakładką.

Składnia

      void SetBookmark( 
   const CDBVariant& varBookmark  
);

Parametry

  • varBookmark
    Odwołanie do CDBVariant wartość zakładki dla określonego rekordu zawierającego obiekt.

Uwagi

Aby ustalić, jeżeli zakładki są obsługiwane na zestawie rekordów, call CanBookmark.Aby udostępnić zakładek, jeśli są obsługiwane, należy ustawić CRecordset::useBookmarks opcji w dwOptions parametr Otwórz funkcji składowej.

Uwaga

Jeśli zakładki są niedostępne lub nieobsługiwana, wywołanie SetBookmark spowoduje wyjątek jest.Zakładki nie są obsługiwane w zestawy rekordów tylko do przodu.

Najpierw pobrać zakładki dla bieżącego rekordu, call GetBookmark, który zapisuje wartość zakładki do CDBVariant obiektu.Później można wrócić do tego rekordu przez wywołanie SetBookmark przy użyciu wartości zapisane zakładki.

Uwaga

Po niektórych operacji zestawu rekordów, należy sprawdzić trwałość zakładki przed wywoływaniem SetBookmark.Na przykład pobrać zakładki z GetBookmark , a następnie wywołać Requery, zakładka przestaną być ważne.Wywołanie CDatabase::GetBookmarkPersistence , aby sprawdzić, czy można bezpiecznie wywołać SetBookmark.

Aby uzyskać więcej informacji na temat zakładek i nawigacji zestawu rekordów, zobacz artykuły rekordów: zakładki i pozycje bezwzględne (ODBC) i rekordów: przewijanie (ODBC).

Wyjątki

Exception

Condition

Tej metody można zgłosić wyjątków typu CDBException * i CMemoryException*.

Wymagania

Nagłówek: afxdb.h

Zobacz też

Klasa CRecordset
Diagram hierarchii
CRecordset::CanBookmark
CRecordset::GetBookmark
CRecordset::SetAbsolutePosition
CDatabase::GetBookmarkPersistence