Поделиться через


Прокрутка и выборка строк (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. Рекомендации по драйверам для обеспечения обратной совместимости.