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 |