Создание закладок строк в ODBC

Закладка представляет собой значение, используемое для идентификации строки данных. Содержание значения закладки понятно только драйверу или источнику данных. Например, оно может быть простым (номером строки) или сложным (адрес на диске). В ODBC приложение запрашивает закладку для конкретной строки, сохраняет ее и передает обратно курсору для возврата к строке.

При выборке строк через функцию SQLFetchScroll приложение может использовать закладку для выборки начальной строки. Такой способ представляет собой форму абсолютной адресации, поскольку не зависит от текущей позиции курсора. Чтобы выполнить прокрутку в строке с закладкой, приложение вызывает функцию SQLFetchScroll со значением SQL_FETCH_BOOKMARK аргумента FetchOrientation. Эта операция использует закладку, на которую указывает атрибут параметра SQL_ATTR_FETCH_BOOKMARK_PTR. Она возвращает набор строк, начинающийся со строки, определяемой закладкой. Приложение может указать смещение для этой операции в аргументе FetchOffset вызова функции SQLFetchScroll. При указании смещения первая строка возвращаемого набора строк определяется сложением числа в аргументе FetchOffset с номером строки, определяемой закладкой. Поставщик OLE DB для собственного клиента SQL Server поддерживает только закладки в статических курсорах и курсорах, управляемых набором ключей. Если при включенных закладках запрошен динамический курсор, то вместо него открывается курсор, управляемый набором ключей.

Закладки могут также использоваться с функцией SQLBulkOperations для выполнения различных операций над набором строк, начиная с закладки.

См. также

Основные понятия

Прокрутка и выборка строк