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