CRecordset::SetBookmark

аннулировать SetBookm&ark (const CDBVariantamp; varBookmark );
Бросай (CDBException, CMemoryException);

Параметры

varBookmark

Ссылка на объект CDBVariant , содержащий значение закладки для определенной записи.

Примечания

Вызов этой функции-члена для размещения набора записей на запись, содержащая указанной закладкой. Чтобы определить, если закладки поддерживаются на набор записей, вызовите CanBookmark. Чтобы сделать доступным, если они поддерживаются закладки, необходимо установить параметр CRecordset::useBookmarks в параметре dwOptions функции-члена Open.

Примечание   Если закладки не поддерживается или недоступен, вызов SetBookmark приведет к созданию исключения. Закладки не поддерживаются только наборы записей.

Для первого извлечь закладку в текущей записи вызовите GetBookmark, который сохраняет значение закладки в объект CDBVariant . Позже вы можете вернуться к этой записи путем вызова SetBookmark с помощью значения, сохраненные закладки.

Примечание   После определенных записей операций следует проверить закладки упорство перед вызовом SetBookmark. К примеру если вы извлечь закладку с GetBookmark и затем вызовите Requery, закладки больше не может быть действительным. Вызовите CDatabase::GetBookmarkPersistence , чтобы проверить ли вы можете безопасно вызвать SetBookmark.

Для получения дополнительных сведений о закладки и навигации набора записей, обратитесь к статьям набор записей: закладки и абсолютной позиции (ODBC) и набор записей: прокрутка (ODBC) в Руководстве по Visual C++ программист.

Обзор CRecordsetЧлены класса | Иерархическая схема

См. также CRecordset::CanBookmark, CRecordset::GetBookmark, CRecordset::SetAbsolutePosition, CDatabase::GetBookmarkPersistence

Index