Sdílet prostřednictvím

CRecordset::SetBookmark

  • Článek

 

Pozice záznamů na záznam obsahující určitou záložku.

Syntaxe

      void SetBookmark( 
   const CDBVariant& varBookmark  
);

Parametry

  • varBookmark
    Odkaz na CDBVariant hodnota záložky pro konkrétní záznam obsahující objekt.

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í SetBookmark výsledkem byla vyvolána výjimka.Záložky nejsou podporovány pouze pro předávání sady záznamů.

Nejprve načíst záložku pro aktuální záznam, volání GetBookmark, který uloží hodnota záložky CDBVariant objektu.Později můžete vrátit k záznamu voláním SetBookmark pomocí záložky uložené hodnoty.

Poznámka

Po určitých operací záznamů zkontrolujte perzistence záložky před voláním SetBookmark .Například načíst Záložka s GetBookmark a potom použijte volání Requery, Záložka již nebude platné.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::GetBookmark
CRecordset::SetAbsolutePosition
CDatabase::GetBookmarkPersistence