CRecordset::SetBookmark

void SetBookm&ark (const CDBVariantamp; varBookmark );
rzut (CDBException, CMemoryException);

Parametry

varBookmark

Odwołanie do obiektu CDBVariant zawierających wartość zakładki dla określonego rekordu.

Uwagi

Wywołanie tej funkcji Państwa do pozycji zestawu rekordów na rekord zawierający określoną zakładką. Aby określić, jeśli zakładki są obsługiwane na zestawie rekordów, wywołanie CanBookmark. Aby udostępnić zakładek, jeśli są one wspierane, należy ustawić opcję CRecordset::useBookmarks w parametrze dwOptions otwartej funkcji członek.

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

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

Uwaganbsp;  Po pewnych operacji rekordów należy sprawdzić trwałość zakładki przed wywołaniem metody SetBookmark. &Na przykład jeśli pobieranie zakładki z GetBookmark , a następnie wywołać Requery, zakładki mogą przestaną być ważne. Wywołanie CDatabase::GetBookmarkPersistence do sprawdzania, czy można bezpiecznie wywołania SetBookmark.

Aby uzyskać więcej informacji na temat zakładek i nawigacji zestawu rekordów, zobacz artykuły rekordów: zakładki i bezwzględne położenie (ODBC) i rekordów: przewijanie (ODBC) w Visual C++ Programmer's Guide.

Omówie&nie CRecordset |nbsp; Klasa członków | Wykres hierarchii

Zobacz też CRecordset::CanBookmark, CRecordset::GetBookmark, CRecordset::SetAbsolutePosition, CDatabase::GetBookmarkPersistence

Index