sp_cursoroption (Transact-SQL)

Si applica a: SQL Server

Imposta le opzioni del cursore o restituisce informazioni sul cursore create dalla sp_cursoropen stored procedure. sp_cursoroption viene richiamato specificando ID = 8 in un pacchetto TDS (Tabular Data Stream).

Convenzioni relative alla sintassi Transact-SQL

Sintassi

sp_cursoroption cursor , code , value
[ ; ]

Argomenti

cursor

Valore handle generato da SQL Server e restituito dalla sp_cursoropen stored procedure. Il parametro del cursore è int e non può essere NULL.

code

Consente di specificare i vari fattori dei valori restituiti del cursore. Il parametro di codice è int e deve essere uno dei valori seguenti:

valore Nome Descrizione
0x0001 TEXTPTR_ONLY Restituisce il puntatore di testo, anziché i dati effettivi, per determinate colonne di tipo text o image designate.

TEXTPTR_ONLY consente l'uso di puntatori di testo come handle agli oggetti BLOB che possono essere recuperati o aggiornati in modo selettivo tramite le funzionalità Transact-SQL o DBLIB, ad esempio Transact-SQL READTEXT o DBLIB DBWRITETEXT.
Se viene assegnato un 0 valore, tutte le colonne di testo e immagine nell'elenco di selezione restituiscono puntatori di testo anziché dati.
0x0002 CURSOR_NAME Assegna il nome specificato nel valore al cursore, che consente a ODBC di usare istruzioni transact-SQL posizionate/UPDATEDELETE sui cursori aperti tramite sp_cursoropen.

La stringa può essere specificata come qualsiasi tipo di dati Unicode o character.
Poiché le istruzioni posizionate transact-SQL funzionano, per impostazione predefinita, nella prima riga di un cursore fat deve sp_cursor SETPOSITION essere usato per posizionare il cursore prima di emettere l'istruzione posizionata/UPDATEDELETE.UPDATE/DELETE
0x0003 TEXTDATA Restituisce i dati effettivi, non il puntatore di testo, per determinate colonne di testo o immagine nei recuperi successivi, ovvero annulla l'effetto di TEXTPTR_ONLY.

Se TEXTDATA è abilitato per una determinata colonna, la riga viene recuperata o aggiornata e può essere reimpostata su TEXTPTR_ONLY. Come con TEXTPTR_ONLY, il parametro value è un numero intero che specifica il numero di colonna e un valore zero restituisce tutte le colonne di testo o immagine.
0x0004 SCROLLOPT Opzione di scorrimento. Per altre informazioni, vedere Restituire valori di codice.
0x0005 CCOPT Opzioni del controllo della concorrenza. Per altre informazioni, vedere Restituire valori di codice.
0x0006 ROWCOUNT Numero di righe correntemente nel set di risultati.

Nota: l'oggetto ROWCOUNT potrebbe essere stato modificato dopo il valore restituito da sp_cursoropen se viene usato il popolamento asincrono. Il valore -1 viene restituito se il numero di righe è sconosciuto.

value

Designa il valore restituito dal codice. value è un parametro obbligatorio che chiama un 0x0001valore di input di codice , 0x0002o 0x0003 .

Un valore di codice di 2 è un tipo di dati stringa. Qualsiasi altro input di valore di codice o restituito da value è un valore int.

Valori del codice restituito

Il parametro value potrebbe restituire uno dei valori di codice seguenti.

Valore restituito Descrizione
0x0004 SCROLLOPT
0X0005 CCOPT
0X0006 ROWCOUNT

Il parametro value restituisce uno dei valori seguenti SCROLLOPT .

Valore restituito Descrizione
0x0001 KEYSET
0x0002 DYNAMIC
0x0004 FORWARD_ONLY
0x0008 STATIC

Il parametro value restituisce uno dei valori seguenti CCOPT .

Valore restituito Descrizione
0x0001 READ_ONLY
0x0002 SCROLL_LOCKS
0x0004 or 0x0008 OPTIMISTIC