sp_cursoroption (Transact-SQL)

Sintassi

        sp_cursoroption 
        cursor
        , 
        code
        , 
        value
      

Argomenti

• cursor
  Valore dell'handle generato da SQL Server e restituito dalla stored procedure sp_cursoropen. Per l'esecuzione di cursor, è richiesto un valore di input int. 

• code
  Consente di specificare i vari fattori dei valori restituiti del cursore. code 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'utilizzo dei puntatori di testo come handle per gli oggetti blob che potranno essere recuperati o aggiornati in modo selettivo in un secondo momento utilizzando Transact-SQL o funzionalità 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 in value al cursore che, a sua volta, consente a ODBC di utilizzare istruzioni Transact-SQL UPDATE/DELETE posizionate sui cursori aperti tramite sp_cursoropen. La stringa può essere specificata come qualsiasi tipo di dati Unicode o character. Poiché, per impostazione predefinita, le istruzioni Transact-SQL UPDATE/DELETE posizionate agiscono sulla prima riga, nel caso di un cursore con un numero elevato di record è consigliabile posizionare il cursore utilizzando sp_cursor SETPOSITION prima di eseguire 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 modificato rispetto al valore restituito da sp_cursoropen, se viene utilizzato il popolamento asincrono. Se il numero di righe non è noto, viene restituito -1.

• value
  Definisce il valore restituito da code. value è un parametro obbligatorio che richiede un valore di input 0x0001, 0x0002 o 0x0003 per code.

  Nota

  Il valore 2 per code indica un tipo di dati stringa. Qualsiasi altro valore di code utilizzato come input o restituito da value è un intero.

Valori di codice restituiti

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

Il parametro value restituisce uno dei valori di SCROLLOPT seguenti.

Il parametro value restituisce uno dei valori di CCOPT seguenti.

Vedere anche

Riferimento

Altre risorse