CRecordset::GetBookmark

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

Parametry

varBookmark

Odwołanie do obiektu CDBVariant , reprezentujące zakładki w bieżącym rekordzie.

Uwagi

Wywołanie tej funkcji Państwa do uzyskania wartości zakładki dla bieżącego rekordu. 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 GetBookmark spowoduje wyjątek są generowane. Zakładki nie są obsługiwane tylko do przodu zestawy rekordów.

GetBookmark przypisuje wartość zakładki dla bieżącego rekordu do obiektu CDBVariant . Aby powrócić do tego rekordu w dowolnym momencie po przeniesieniu do innego rekordu, wywołać SetBookmark odpowiedni obiekt CDBVariant.

Uwaganbsp;  Po pewnych operacji rekordów zakładki może nie być prawidłowe. &Na przykład jeśli zostanie wywołana GetBookmark następuje Requery, nie można możliwość powrotu do rekordu z SetBookmark. 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::SetBookmark, CDatabase::GetBookmarkPersistence

Index