Rolar e buscar linhas (ODBC)

Ao usar um cursor rolável, os aplicativos chamam SQLFetchScroll para posicionar o cursor e buscar linhas. O SQLFetchScroll dá suporte à rolagem relativa (próximas n linhas, anteriores) e absoluta (primeiro, último, e linha n), além de posicionamento por marcador. Os argumentos FetchOrientation e FetchOffset no SQLFetchScroll especificam qual conjunto de linhas buscar, conforme mostrado nos diagramas a seguir.

Buscando os Próximos, Anteriores, Primeiros e Últimos Conjuntos de Linhas

Buscando conjuntos de linhas absolutas, relativas e com marcadores

SQLFetchScroll posiciona o cursor para a linha especificada e retorna as linhas no conjunto de linhas começando com essa linha. Se o conjunto de linhas especificado se sobrepor ao final do conjunto de resultados, um conjunto de linhas parcial será retornado. Se o conjunto de linhas especificado se sobrepor ao início do conjunto de resultados, o primeiro conjunto de linhas no conjunto de resultados geralmente será retornado; para obter detalhes completos, consulte a descrição da função SQLFetchScroll .

Em alguns casos, o aplicativo pode querer posicionar o cursor sem recuperar dados. Por exemplo, talvez ele queira testar se existe uma linha ou apenas obter o indicador da linha sem trazer outros dados pela rede. Para fazer isso, ele define o atributo de instrução SQL_ATTR_RETRIEVE_DATA como SQL_RD_OFF. A variável associada à coluna de marcador (se houver) sempre é atualizada, independentemente da configuração deste atributo de instrução.

Depois que o conjunto de linhas for recuperado, o aplicativo poderá chamar SQLSetPos para posicionar em uma linha específica no conjunto de linhas ou atualizar linhas no conjunto de linhas. Para obter mais informações sobre como usar SQLSetPos, consulte Atualizando dados com SQLSetPos.

Observação

O suporte para rolagem nos drivers ODBC 2.x é fornecido por SQLExtendedFetch. Para obter mais informações, consulte Cursores de Bloco, Cursores Roláveis e Compatibilidade com Versões Anteriores no Apêndice G: Diretrizes de Driver para Compatibilidade com Versões Anteriores.