sp_cursoroption (Transact-SQL)

Si applica a: SQL Server (tutte le versioni supportate)

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

Convenzioni della sintassi Transact-SQL

Sintassi

  
sp_cursoroption cursor, code, value  

Argomenti

cursor
Valore dell'handle generato da SQL Server e restituito dal sp_cursoropen stored procedure. cursor richiede un valore di input int per l'esecuzione.

code
Consente di specificare i vari fattori dei valori restituiti del cursore. il codice richiede uno dei valori di input int 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 i puntatori di testo possono essere usati come handle per gli oggetti BLOB che possono essere successivamente recuperati o aggiornati in modo selettivo usando le funzionalità o DBLIB (ad esempio READTEXT o Transact-SQL Transact-SQL DBLIB DBWRITETEXT). Se viene assegnato il valore "0", tutte le colonne di tipo text e image nell'elenco di selezione restituiranno puntatori di testo anziché dati.
0x0002	CURSOR_NAME	Assegna il nome specificato in value al cursore. Ciò consente a ODBC di usare istruzioni UPDATE/DELETE posizionate sui Transact-SQL cursori aperti tramite sp_cursoropen. La stringa può essere specificata come qualsiasi tipo di dati Unicode o character. Poiché le istruzioni UPDATE/DELETE posizionate operano, per impostazione predefinita, nella prima riga di un cursore fat è necessario usare sp_cursor SETPOSITION per posizionare il cursore prima di eseguire l'istruzione Transact-SQL UPDATE/DELETE posizionata.
0x0003	TEXTDATA	Restituisce i dati effettivi, anziché il puntatore di testo, per determinate colonne di tipo text o image in recuperi successivi, ovvero annulla l'effetto di TEXTPTR_ONLY. Se per una colonna specifica è abilitato TEXTDATA, la riga viene nuovamente recuperata o aggiornata e può quindi essere nuovamente impostata su TEXTPTR_ONLY. Analogamente a quanto accade per TEXTPTR_ONLY, il parametro di valore è un intero che specifica il numero di colonna e un valore zero restituisce tutte le colonne di tipo text o image.
0x0004	SCROLLOPT	Opzione di scorrimento. Per ulteriori informazioni, vedere "Valori dei codici restituiti" più avanti in questo argomento.
0x0005	CCOPT	Opzioni del controllo della concorrenza. Per ulteriori informazioni, vedere "Valori dei codici restituiti" più avanti in questo argomento.
0x0006	ROWCOUNT	Numero di righe correntemente nel set di risultati. Nota: è possibile che ROWCOUNT sia stato modificato dopo il valore restituito da sp_cursoropen se viene utilizzato il popolamento asincrono. Se il numero di righe è sconosciuto, viene restituito il valore -1.

value
Definisce il valore restituito dal codice. value è un parametro obbligatorio che chiama per un 0x0001, 0x0002 o 0x0003 di input del codice.

Nota

Un valore di codice pari a 2 è un tipo di dati stringa. Qualsiasi altro valore di codice immesso o restituito da value è un numero intero.

Valori del codice restituito

Il parametro value può restituire uno dei valori di codice seguenti.

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

Il parametro value restituisce uno dei valori SCROLLOPT seguenti.

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

Il parametro value restituisce uno dei valori CCOPT seguenti.

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

Vedere anche

Stored procedure di sistema (Transact-SQL)
sp_cursor (Transact-SQL)
sp_cursoropen (Transact-SQL)