Rolagem e obtenção de linhas (ODBC)

Ao usar um cursor deslizável, as aplicações chamam SQLFetchScroll para posicionar o cursor e buscar linhas. O SQLFetchScroll suporta scroll relativo (seguinte, anterior e relativas n linhas), scroll absoluto (primeiras, últimas e linha n) e posicionamento por marcador. Os argumentos FetchOrientation e FetchOffset em SQLFetchScroll especificam qual conjunto de linhas buscar, como mostrado nos diagramas seguintes.

Buscar Próximo, Anterior, Primeiro e Último Conjuntos de Linhas

Buscar Conjuntos de Linhas Absolutas, Relativas e Marcadas nos Favoritos

SQLFetchScroll posiciona o cursor na linha especificada e devolve as linhas do conjunto de linhas a partir dessa linha. Se o conjunto de linhas especificado se sobrepor ao final do conjunto de resultados, é devolvida uma linha parcial. Se o conjunto de linhas especificado se sobrepor ao início do conjunto de resultados, o primeiro conjunto de linhas do conjunto de resultados é geralmente devolvido; para detalhes completos, consulte a descrição da função SQLFetchScroll .

Em alguns casos, a aplicação pode querer posicionar o cursor sem recuperar quaisquer dados. Por exemplo, pode querer testar se existe uma linha ou simplesmente obter o marcador da linha sem transferir outros dados pela rede. Para isso, define o atributo de instrução SQL_ATTR_RETRIEVE_DATA a SQL_RD_OFF. A variável atribuída à coluna de favoritos (se existir) é sempre atualizada, independentemente da definição deste atributo de instrução.

Depois de o conjunto de linhas ter sido recuperado, a aplicação pode chamar SQLSetPos para posicionar numa linha específica do conjunto de linhas ou atualizar linhas nesse conjunto. Para mais informações sobre a utilização de SQLSetPos, consulte Atualização de Dados com SQLSetPos.

Observação

O suporte ao scrolling é fornecido nos drivers ODBC 2.x através de SQLExtendedFetch. Para mais informações, consulte Cursores de Bloco, Cursores Roláveis e Compatibilidade Retroativa no Apêndice G: Diretrizes de Drivers para Compatibilidade Retroativa.