Метод CompareBookmarks (ADO)

  • Статья

Сравнивает две закладки и возвращает сведения об их относительных значениях.

Синтаксис

  
result = recordset.CompareBookmarks(Bookmark1, Bookmark2)

Возвращаемое значение

Возвращает значение CompareEnum , указывающее относительное положение строк двух записей, представленных их закладками.

Параметры

Bookmark1
Закладка первой строки.

Bookmark2
Закладка второй строки.

Комментарии

Закладки должны применяться к одному и тому же объекту Recordset или объекту Recordset и его клону. Вы не можете надежно сравнивать закладки из разных объектов Recordset , даже если они были созданы из одного источника или команды. Также нельзя сравнивать закладки для объекта Recordset, базовый поставщик которого не поддерживает сравнения.

Закладка однозначно идентифицирует строку в объекте Recordset . Чтобы получить закладку, используйте свойство Bookmark текущей строки.

Так как тип данных закладки относится к каждому поставщику, ADO предоставляет его как Variant. Например, SQL Server закладки относятся к типу DBTYPE_R8 (Double). ADO будет предоставлять этот тип как Variant с подтипом Double.

При сравнении закладок ADO не пытается выполнить приведение какого-либо типа. Значения просто передаются поставщику, в котором выполняется сравнение. Если закладки, передаваемые в метод CompareBookmarks , хранятся в переменных разных типов, это может привести к следующей ошибке несоответствия типов: "Аргументы имеют неправильный тип, находятся вне допустимого диапазона или конфликтуют друг с другом".

Недопустимая или неправильно сформированная закладка приведет к ошибке.

Применение

Объект Recordset (ADO)

См. также:

Пример метода CompareBookmarks (Visual Basic)
Пример метода CompareBookmarks (Visual C++)
Свойство Bookmark (ADO)