CRecordset::SetBookmark
Располагает набор записей на запись, содержащий указанную закладку.
void SetBookmark(
const CDBVariant& varBookmark
);
Параметры
- varBookmark
Ссылка на объект CDBVariant, содержащий значение для конкретной записи.
Заметки
Определить, закладки, поддерживаются в наборе записей, то вызов CanBookmark. Чтобы сделать доступными закладки, если они поддерживаются, то необходимо установить параметр CRecordset::useBookmarks в параметре dwOptions функции-члена Открытие.
Примечание
Если недоступна или не поддерживаются закладки, вызывать SetBookmark приведет к исключению исключении.Закладки не поддерживаются в наборах записей - только вперед.
Сначала извлечь закладку для текущей записи вызова GetBookmark, который сохраняет значение закладки в объект CDBVariant. Далее можно вернуться к этой записи путем вызова SetBookmark с помощью сохраненное значение закладки.
Примечание
После некоторых операций набора записей необходимо проверить сохраняемость закладки перед вызовом SetBookmark.Например, при восстановлении закладка, с GetBookmark и затем вызовите Requery, то закладки больше не сможет быть допустимой.Вызовите CDatabase::GetBookmarkPersistence чтобы проверить, можно ли безопасно вызывать SetBookmark.
Дополнительные сведения о закладках и перемещении по набору записей см. статьи Набор записей. Закладки и абсолютное позиционирование (ODBC) и Набор записей. Прокрутка (ODBC).
Исключения
Этот метод может создавать исключения типа CDBException* и CMemoryException*.
Требования
Header: afxdb.h