sp_cursoroption (Transact-SQL)

  • Artikel

Gilt für: SQL Server

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

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-positionierteDELETE UPDATE/Anweisungen für Cursor verwenden kann, die über sp_cursoropengeö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, sp_cursor SETPOSITION um den Cursor vor dem Ausgeben der positionierten/DELETE UPDATEAnweisung 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_ONLYdiesem 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 0x0003 codeeingabewert 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

Zugehöriger Inhalt