Поделиться через


CRecordset::GetBookmark

Получает значение закладки для текущей записи.

void GetBookmark( 
   CDBVariant& varBookmark  
);

Параметры

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

Заметки

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

Примечание

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

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

Примечание

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

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

Исключения

Этот метод может создавать исключения типа CDBException* и CMemoryException*.

Требования

Header: afxdb.h

См. также

Ссылки

Класс CRecordset

Диаграмма иерархии

CRecordset::CanBookmark

CRecordset::SetBookmark

CDatabase::GetBookmarkPersistence