Condividi tramite


Scorrimento e recupero di righe

Si applica a: SQL Server Database SQL di Azure Istanza gestita di SQL di Azure Azure Synapse Analytics Piattaforma di strumenti analitici (PDW)

Per utilizzare un cursore scorrevole, un'applicazione ODBC deve effettuare le operazioni seguenti:

  • Impostare le funzionalità del cursore usando SQLSetStmtAttr.

  • Aprire il cursore usando SQLExecute o SQLExecDirect.

  • Scorrere e recuperare righe usando SQLFetch o SQLFetchScroll.

Sia SQLFetch che SQLFetchSroll possono recuperare blocchi di righe alla volta. Il numero di righe restituite viene specificato usando SQLSetStmtAttr per impostare il parametro SQL_ATTR_ROW_ARRAY_SIZE.

Le applicazioni ODBC possono usare SQLFetch per recuperare tramite un cursore forward-only.

SQLFetchScroll viene usato per scorrere un cursore. SQLFetchScroll supporta il recupero dei set di righe successivi, precedenti, primi e ultimi oltre al recupero relativo (recuperare il set di righe n righe dall'inizio del set di righe corrente) e il recupero assoluto (recuperare il set di righe a partire dalla riga n). Se n è negativo in un recupero assoluto, le righe vengono conteggiate dalla fine del set di risultati. Un recupero assoluto della riga -1 indica il recupero del set di righe che inizia con l'ultima riga nel set di risultati.

È probabile che le applicazioni che usano SQLFetchScroll solo per le sue capacità di cursore rettangolare, ad esempio i report, passino attraverso il set di risultati una singola volta, usando solo l'opzione per recuperare il set di righe successivo. Le applicazioni basate su schermo, d'altra parte, possono sfruttare tutte le capacità di SQLFetchScroll. Se l'applicazione imposta le dimensioni del set di righe sul numero di righe visualizzate sullo schermo e associa i buffer dello schermo al set di risultati, è possibile convertire le operazioni della barra di scorrimento direttamente in chiamate a SQLFetchScroll.

Operazione della barra di scorrimento Opzione di scorrimento SQLFetchScroll
Su di una pagina SQL_FETCH_PRIOR
Giù di una pagina SQL_FETCH_NEXT
Su di una riga SQL_FETCH_RELATIVE con FetchOffset uguale a -1
Giù di una riga SQL_FETCH_RELATIVE con FetchOffset uguale a 1
Casella di scorrimento all'inizio SQL_FETCH_FIRST
Casella di scorrimento alla fine SQL_FETCH_LAST
Posizione casuale della casella di scorrimento SQL_FETCH_ABSOLUTE

In questa sezione

Vedi anche

Uso dei cursori (ODBC)