CRecordset::SetBookmark
Pozice záznamů na záznam obsahující určitou záložku.
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
Tuto metodu lze vyvolávají výjimky typu CDBException * a CMemoryException* .
Požadavky
Záhlaví: afxdb.h