sp_cursoroption (Transact-SQL)

Si applica a:SQL Server

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

Convenzioni di sintassi Transact-SQL

Sintassi

  
sp_cursoroption cursor, code, value  

Argomenti

cursor
Valore handle generato da SQL Server e restituito dalla stored procedure sp_cursoropen. 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 consente l'uso di puntatori di testo come handle agli oggetti BLOB che possono essere recuperati o aggiornati in un secondo momento tramite funzionalità Transact-SQL o DBLIB ,ad esempio Transact-SQL READTEXT o 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 nel valore al cursore. In questo modo, a sua volta, consente a ODBC di usare istruzioni UPDATE/DELETE posizionate transact-SQL sui cursori aperti tramite sp_cursoropen. La stringa può essere specificata come qualsiasi tipo di dati Unicode o character. Poiché le istruzioni UPDATE/DELETE posizionate in Transact-SQL funzionano, per impostazione predefinita, nella prima riga di un cursore fat, sp_cursor SETPOSITION deve essere usata per posizionare il cursore prima di emettere l'istruzione 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 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 0x0001, 0x0002 o 0x0003 valore di input del codice .

Nota

Il valore di codice 2 è un tipo di dati stringa. Qualsiasi altro input di valore di codice 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

Vedi anche

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