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

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

Выборка следующего, предыдущего, первого и последнего набора строк

Выборка следующего, предыдущего, первого и последнего набора строк

Выборка абсолютных, относительных наборов строк и наборов строк с закладками

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

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

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

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

Примечание

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