CRecordset::GetBookmark
Pobiera wartość zakładki dla bieżącego rekordu.
void GetBookmark(
CDBVariant& varBookmark
);
Parametry
- varBookmark
Odwołanie do CDBVariant obiekt reprezentujący zakładki do bieżącego rekordu.
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 GetBookmark spowoduje wyjątek jest.Zakładki nie są obsługiwane w zestawy rekordów tylko do przodu.
GetBookmarkprzypisuje wartość zakładki dla bieżącego rekordu CDBVariant obiektu.Aby powrócić do tego rekordu w dowolnym czasie po przeniesieniu do innego rekordu, call SetBookmark z odpowiednimi CDBVariant obiektu.
[!UWAGA]
Po pewnych operacji rekordów zakładki można prawidłowy.Na przykład, jeśli GetBookmark następuje Requery, nie można powrócić do rekordu z SetBookmark.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
Tej metody można zgłosić wyjątków typu CDBException * i CMemoryException*.
Wymagania
Nagłówek: afxdb.h