CRecordset::GetBookmark

 

Získá hodnota záložky pro aktuální záznam.

Syntaxe

      void GetBookmark( 
   CDBVariant& varBookmark  
);

Parametry

• varBookmark
  Odkaz na CDBVariant objekt představující záložku na aktuální záznam.

Poznámky

K určení, pokud jsou podporovány záložky v sadě záznamů, volání CanBookmark.K dispozici, pokud jsou podporovány záložky, je nutné nastavit CRecordset::useBookmarks možnost dwOptions parametr otevřených členské funkce.

Poznámka

Pokud záložky nepodporovaný nebo není k dispozici, volání GetBookmark výsledkem byla vyvolána výjimka.Záložky nejsou podporovány pouze pro předávání sady záznamů.

GetBookmarkpřiřadí hodnota záložky pro aktuální záznam CDBVariant objektu.Kdykoli po přesunutí na jiný záznam vrátit k, zavolejte na SetBookmark s odpovídajícím CDBVariant objektu.

Poznámka

Po určitých operací recordset záložky již nemusí být platné.Například volání GetBookmark a Requery, nebudete moci vrátit záznam s SetBookmark .Volání CDatabase::GetBookmarkPersistence zkontrolujte, zda lze bezpečně volat SetBookmark .

Další informace o záložky a navigační sady záznamů naleznete v článcích záznamů: záložky a absolutní pozice (ODBC) a záznamů: posouvání (ODBC).

Výjimky

Exception

Condition

Tuto metodu lze vyvolávají výjimky typu CDBException * a CMemoryException* .

Požadavky

Záhlaví: afxdb.h

Viz také

Třída CRecordset
Graf hierarchie
CRecordset::CanBookmark
CRecordset::SetBookmark
CDatabase::GetBookmarkPersistence