CRecordset::SetBookmark

Статья
02/20/2013

Располагает набор записей на запись, содержащий указанную закладку.

void SetBookmark( 
   const CDBVariant& varBookmark  
);

Параметры

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

Заметки

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

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

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

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

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

Дополнительные сведения о закладках и перемещении по набору записей см. статьи Набор записей. Закладки и абсолютное позиционирование (ODBC) и Набор записей. Прокрутка (ODBC).