CRecordset::SetBookmark
Pozycje zestawu rekordów do rekordu zawierającego zakładką.
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
Tej metody można zgłosić wyjątków typu CDBException * i CMemoryException*.
Wymagania
Nagłówek: afxdb.h