sp_cursoroption (Transact-SQL)

Artikel
2025-03-11

Legt Cursoroptionen fest oder gibt Cursorinformationen zurück, die von der sp_cursoropen gespeicherten Prozedur erstellt wurden. sp_cursoroption wird aufgerufen, indem in einem TDS-Paket (Tabular Data Stream) angegeben ID = 8 wird.

Transact-SQL-Syntaxkonventionen

Syntax

sp_cursoroption cursor , code , value
[ ; ]

Argumente

Wichtig

Argumente für erweiterte gespeicherte Prozeduren müssen in der spezifischen Reihenfolge eingegeben werden, wie im Abschnitt Syntax beschrieben. Wenn die Parameter außerhalb der Reihenfolge eingegeben werden, tritt eine Fehlermeldung auf.

Cursor

Ein handle von SQL Server generierter Wert und wird von der sp_cursoropen gespeicherten Prozedur zurückgegeben. Der Cursorparameter ist int und kann nicht sein NULL.

code

Wird verwendet, um verschiedene Faktoren der Cursorrückgabewerte festzulegen. Der Codeparameter ist int und muss einen der folgenden Werte aufweisen:

Wert	Name	Beschreibung
`0x0001`	`TEXTPTR_ONLY`	Gibt für bestimmte angegebene Text- oder Bildspalten den Textzeiger, nicht aber die tatsächlichen Daten zurück. `TEXTPTR_ONLY` ermöglicht die Verwendung von Textzeigern als Handles für BLOB-Objekte, die später mithilfe von Transact-SQL- oder DBLIB-Einrichtungen (z. B. Transact-SQL `READTEXT` oder DBLIB `DBWRITETEXT`) selektiv abgerufen oder aktualisiert werden können. Wenn ein `0` Wert zugewiesen ist, geben alle Text- und Bildspalten in der Auswahlliste Textzeiger anstelle von Daten zurück.
`0x0002`	`CURSOR_NAME`	Weist dem Cursor den im Wert angegebenen Namen zu, wodurch ODBC Transact-SQL-positionierte`UPDATE`/`DELETE`Anweisungen für Cursor verwenden kann, die über `sp_cursoropen`geöffnet werden. Die Zeichenfolge kann als beliebiges Zeichen oder Unicode-Datentyp angegeben werden. Da Transact-SQL-Positionierte Anweisungen standardmäßig in der ersten Zeile eines Fettcursors ausgeführt werden, sollte verwendet werden, `UPDATE` um den Cursor vor dem Ausgeben der positionierten/`DELETEsp_cursor SETPOSITION`Anweisung zu positionieren.`UPDATE`/`DELETE`
`0x0003`	`TEXTDATA`	Gibt die tatsächlichen Daten, nicht den Textzeiger, für bestimmte Text- oder Bildspalten für nachfolgende Abrufe zurück (d. a. dies macht den Effekt rückgängig `TEXTPTR_ONLY`). Wenn `TEXTDATA` für eine bestimmte Spalte aktiviert ist, wird die Zeile zurückgesendet oder aktualisiert und kann dann zurück auf `TEXTPTR_ONLY`. Wie bei `TEXTPTR_ONLY`diesem Parameter ist der Wertparameter eine ganze Zahl, die die Spaltennummer angibt und ein Nullwert alle Text- oder Bildspalten zurückgibt.
`0x0004`	`SCROLLOPT`	Option für den Bildlauf. Weitere Informationen finden Sie unter Rückgabecodewerte.
`0x0005`	`CCOPT`	Option für die Parallelitätssteuerung. Weitere Informationen finden Sie unter Rückgabecodewerte.
`0x0006`	`ROWCOUNT`	Die Anzahl der aktuell im Resultset enthaltenen Zeilen. Hinweis: Möglicherweise `ROWCOUNT` wurde der Wert geändert, der zurückgegeben `sp_cursoropen` wird, wenn asynchrone Grundgesamtheit verwendet wird. Der Wert `-1` wird zurückgegeben, wenn die Anzahl der Zeilen unbekannt ist.

value

Legt den von Code zurückgegebenen Wert fest. "value " ist ein erforderlicher Parameter, der einen 0x0001Eingabewert 0x0002oder 0x0003codeeingabewert aufruft.

Ein Codewert von 2 ist ein Zeichenfolgendatentyp. Alle anderen Codewerteingaben oder vom Wert zurückgegebenen Codewerte sind ein Int.

Rückgabecodewerte

Der Wertparameter gibt möglicherweise einen der folgenden Codewerte zurück.

Rückgabewert	Beschreibung
`0x0004`	`SCROLLOPT`
`0X0005`	`CCOPT`
`0X0006`	`ROWCOUNT`

Der Wertparameter gibt einen der folgenden SCROLLOPT Werte zurück.

Rückgabewert	Beschreibung
`0x0001`	`KEYSET`
`0x0002`	`DYNAMIC`
`0x0004`	`FORWARD_ONLY`
`0x0008`	`STATIC`

Der Wertparameter gibt einen der folgenden CCOPT Werte zurück.

Rückgabewert	Beschreibung
`0x0001`	`READ_ONLY`
`0x0002`	`SCROLL_LOCKS`
`0x0004 or 0x0008`	`OPTIMISTIC`

Freigeben über