Dela via

sp_cursoroption (Transact-SQL)

  • Artikel

gäller för:SQL Server

Anger marköralternativ eller returnerar markörinformation som skapats av den sp_cursoropen lagrade proceduren. sp_cursoroption anropas genom att ange ID = 8 i ett TDS-paket (Tabular Data Stream).

Transact-SQL syntaxkonventioner

Syntax

sp_cursoroption cursor , code , value
[ ; ]

Argument

Viktig

Argument för utökade lagrade procedurer måste anges i den specifika ordning som beskrivs i avsnittet Syntax. Om parametrarna anges i fel ordning visas ett felmeddelande.

markören

Ett handle värde som genereras av SQL Server och returneras av den sp_cursoropen lagrade proceduren. -markören parametern är int och kan inte NULL.

kod

Används för att ange olika faktorer för markörens returvärden. Parametern kod är intoch måste vara något av följande värden:

Värde Namn Beskrivning
0x0001 TEXTPTR_ONLY Returnerar textpekaren och inte faktiska data för vissa avsedda text- eller bildkolumner.

TEXTPTR_ONLY gör att textpekare kan användas som hanterar till blobobjekt som senare kan hämtas eller uppdateras selektivt med hjälp av Transact-SQL- eller DBLIB-anläggningar (till exempel Transact-SQL READTEXT eller DBLIB-DBWRITETEXT).
Om ett 0 värde tilldelas returnerar alla text- och bildkolumner i den valda listan textpekare i stället för data.
0x0002 CURSOR_NAME Tilldelar det namn som anges i värde till markören, vilket gör att ODBC kan använda Transact-SQL placerade UPDATE/DELETE-instruktioner på markörer som öppnas via sp_cursoropen.

Strängen kan anges som valfritt tecken eller Unicode-datatyp.
Eftersom Transact-SQL positionerade UPDATE/DELETE-instruktioner används som standard på den första raden i en fettmarkör bör sp_cursor SETPOSITION användas för att placera markören innan du utfärdar den positionerade UPDATE/DELETE-instruktionen.
0x0003 TEXTDATA Returnerar faktiska data, inte textpekaren, för vissa text- eller bildkolumner vid efterföljande hämtningar (dvs. detta återställer effekten av TEXTPTR_ONLY).

Om TEXTDATA är aktiverat för en viss kolumn, kommer raden att uppdateras igen och kan sedan ställas in på TEXTPTR_ONLY. Precis som med TEXTPTR_ONLYär värdeparametern ett heltal som anger kolumnnumret och ett nollvärde returnerar alla text- eller bildkolumner.
0x0004 SCROLLOPT Rullningsalternativ. Mer information finns i Returnera kodvärden.
0x0005 CCOPT Alternativ för samtidighetskontroll. Mer information finns i Returnera kodvärden.
0x0006 ROWCOUNT Antalet rader som för närvarande finns i resultatuppsättningen.

Obs!ROWCOUNT kan ha ändrats sedan värdet som returnerades av sp_cursoropen om asynkron population används. Värdet -1 returneras om antalet rader är okänt.

värde

Anger värdet som returneras av kod. värde är en obligatorisk parameter som anropar ett 0x0001, 0x0002eller 0x0003kod indatavärde.

Ett kod värdet för 2 är en strängdatatyp. Andra kod värdeindata eller som returneras av värde är en int.

Returnera kodvärden

Parametern kan returnera något av följande kod värden.

Returvärde Beskrivning
0x0004 SCROLLOPT
0X0005 CCOPT
0X0006 ROWCOUNT

Parametern returnerar något av följande SCROLLOPT värden.

Returvärde Beskrivning
0x0001 KEYSET
0x0002 DYNAMIC
0x0004 FORWARD_ONLY
0x0008 STATIC

Parametern returnerar något av följande CCOPT värden.

Returvärde Beskrivning
0x0001 READ_ONLY
0x0002 SCROLL_LOCKS
0x0004 or 0x0008 OPTIMISTIC

Relaterat innehåll