Condividi tramite


Scorrimento e recupero di righe (ODBC)

Quando si usa un cursore scorrevole, le applicazioni chiamano SQLFetchScroll per posizionare il cursore e recuperare le righe. SQLFetchScroll supporta lo scorrimento relativo (n righe successive, precedenti e relative), lo scorrimento assoluto (prima, ultima e n riga) e il posizionamento in base al segnalibro. Gli argomenti FetchOrientation e FetchOffset in SQLFetchScroll specificano il set di righe da recuperare, come illustrato nei diagrammi seguenti.

Recupero di set di righe successivi, precedenti, primo e ultimo

Recupero di set di righe successivi, precedenti, primo e ultimo

Recupero di set di righe assoluti, relativi e con segnalibri

Recupero di set di righe assoluti, relativi e con segnalibri

SQLFetchScroll posiziona il cursore sulla riga specificata e restituisce le righe nel set di righe a partire da tale riga. Se il set di righe specificato si sovrappone alla fine del set di risultati, viene restituito un set di righe parziale. Se il set di righe specificato si sovrappone all'inizio del set di risultati, generalmente viene restituito il primo set di righe nel set di risultati. Per informazioni dettagliate e complete, vedere la descrizione della funzione SQLFetchScroll.

In alcuni casi, l'applicazione potrebbe posizionare il cursore senza recuperare dati. Ad esempio, potrebbe essere necessario testare se esiste una riga o semplicemente ottenere il segnalibro per la riga senza portare altri dati nella rete. A tale scopo, imposta l'attributo dell'istruzione SQL_ATTR_RETRIEVE_DATA su SQL_RD_OFF. La variabile associata alla colonna segnalibro (se presente) viene sempre aggiornata, indipendentemente dall'impostazione di questo attributo di istruzione.

Dopo aver recuperato il set di righe, l'applicazione può chiamare SQLSetPos per posizionare una determinata riga nel set di righe o aggiornare le righe nel set di righe. Per altre informazioni sull'uso di SQLSetPos, vedere Aggiornamento dei dati con SQLSetPos.

Nota

Lo scorrimento è supportato nei driver ODBC 2.x da SQLExtendedFetch. Per altre informazioni, vedere Cursori rettangolari, cursori scorrevoli e compatibilità con le versioni precedenti nell'Appendice G: Linee guida del driver per la compatibilità con le versioni precedenti.