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 (righe successive, precedenti e relative n), lo scorrimento assoluto (prima, ultima e riga n) 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 del rowset successivo, precedente, primo e ultimo

Recupero del rowset successivo, precedente, primo e ultimo

Recupero di un rowset assoluto, relativo e con segnalibro

Recupero di set di righe assoluti, relativi e con segnalibro

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, viene in genere restituito il primo set di righe nel set di risultati. Per informazioni dettagliate, vedere la descrizione della funzione SQLFetchScroll.

In alcuni casi, l'applicazione potrebbe voler posizionare il cursore senza recuperare dati. Ad esempio, potrebbe essere necessario verificare se una riga esiste o semplicemente ottenere il segnalibro per la riga senza inserire altri dati in rete. A tale scopo, imposta l'attributo SQL_ATTR_RETRIEVE_DATA'istruzione su SQL_RD_OFF. La variabile associata alla colonna del 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 posizionarsi su 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 in ODBC 2. x driver di SQLExtendedFetch. Per altre informazioni, vedere Cursori a blocchi, Cursoriscorrevoli e Compatibilità con le versioni precedenti nell'Appendice G: Linee guida per i driver per la compatibilità con le versioni precedenti.