sp_cursoroption (Transact-SQL)

Si applica a: sì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).

Icona di collegamento a un argomento 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)