Свойство Bookmark (ADO)Bookmark Property (ADO)

Указывает закладку, которая уникально идентифицирует текущую запись в объекте набора записей или устанавливает текущую запись в объекте набора записей в запись, определяемую допустимой закладкой.Indicates a bookmark that uniquely identifies the current record in a Recordset object or sets the current record in a Recordset object to the record identified by a valid bookmark.

Параметры и возвращаемые значенияSettings and Return Values

Задает или возвращает выражение типа Variant , результатом которого является допустимая закладка.Sets or returns a Variant expression that evaluates to a valid bookmark.

RemarksRemarks

Свойство Bookmark используется для сохранения позиции текущей записи и возврата к этой записи в любое время.Use the Bookmark property to save the position of the current record and return to that record at any time. Закладки доступны только в объектах набора записей , поддерживающих функциональность закладок.Bookmarks are available only in Recordset objects that support bookmark functionality.

При открытии объекта набора записей каждая из его записей имеет уникальную закладку.When you open a Recordset object, each of its records has a unique bookmark. Чтобы сохранить закладку для текущей записи, присвойте переменной значение свойства Bookmark .To save the bookmark for the current record, assign the value of the Bookmark property to a variable. Чтобы быстро вернуться к этой записи в любое время после перехода на другую запись, задайте для свойства Bookmark объекта Recordset значение этой переменной.To quickly return to that record at any time after moving to a different record, set the Recordset object's Bookmark property to the value of that variable.

Возможно, пользователь не сможет просмотреть значение закладки.The user may not be able to view the value of the bookmark. Кроме того, пользователи не должны предполагать, что закладки напрямую сравнимы, так как две закладки, которые ссылаются на одну и ту же запись, могут иметь разные значения.Also, users should not expect bookmarks to be directly comparable, because two bookmarks that refer to the same record may have different values.

Если для создания копии объекта набора записей используется метод clone , то параметры свойств закладки для исходного и повторяющегося объектов набора записей идентичны, и их можно использовать взаимозаменяемыми.If you use the Clone method to create a copy of a Recordset object, the Bookmark property settings for the original and the duplicate Recordset objects are identical and you can use them interchangeably. Однако нельзя использовать закладки из разных объектов набора записей , даже если они были созданы из одного и того же источника или команды.However, you cannot use bookmarks from different Recordset objects interchangeably, even if they were created from the same source or command.

Примечание

Использование удаленной службы данных При использовании объекта набора записей на стороне клиента свойство Bookmark всегда доступно.Remote Data Service Usage When used on a client-side Recordset object, the Bookmark property is always available.

ПрименениеApplies To

Объект Recordset (ADO)Recordset Object (ADO)

См. такжеSee Also

Пример свойств BOF, EOF и Bookmark (Visual Basic) BOF, EOF, and Bookmark Properties Example (VB)
Пример свойств BOF, EOF и Bookmark (Visual c++) BOF, EOF, and Bookmark Properties Example (VC++)
Метод SupportsSupports Method