Прокрутка и извлечение строк (ODBC)

При использовании прокручиваемого курсора приложения вызывают SQLFetchScroll для размещения курсора и получения строк. SQLFetchScroll поддерживает относительную прокрутку (следующие, предыдущие и относительные строки n ), абсолютную прокрутку (первую, последнюю и строку n) и размещение по закладке. Аргументы FetchOrientation и FetchOffset в SQLFetchScroll указывают набор строк для получения, как показано на следующих схемах.

Получение первых, следующих, предыдущих и последних наборов строк

Получение абсолютных, относительных и закладных наборов строк

SQLFetchScroll помещает курсор в указанную строку и возвращает строки в наборе строк, начиная с этой строки. Если указанный набор строк выходит за пределы конца результирующего набора, возвращается частичный набор строк. Если указанный набор строк перекрывает начало результирующего набора, то первый набор строк в результирующем наборе обычно возвращается; полные сведения см. в описании функции SQLFetchScroll.

В некоторых случаях приложение может потребоваться разместить курсор без получения данных. Например, может потребоваться проверить, существует ли строка или просто получить закладку для строки без получения других данных в сети. Для этого атрибут SQL_ATTR_RETRIEVE_DATA указывается как SQL_RD_OFF. Переменная, привязанная к столбцу закладки (если она есть), всегда обновляется независимо от параметра этого атрибута инструкции.

После получения набора строк приложение может вызвать SQLSetPos, чтобы позиционировать определенную строку в наборе строк или обновить строки в наборе строк. Дополнительные сведения об использовании SQLSetPos см. в статье об обновлении данных с помощью SQLSetPos.

Замечание

Прокрутка поддерживается в драйверах ODBC версии 2.x с использованием SQLExtendedFetch. Дополнительные сведения см. в разделе "Блокировать курсоры", "Прокручиваемые курсоры" и "Обратная совместимость " в приложении G. Рекомендации по драйверам для обеспечения обратной совместимости.