Sdílet prostřednictvím

sp_cursoroption (Transact-SQL)

  • Článek

platí pro:SQL Server

Nastaví možnosti kurzoru nebo vrátí informace o kurzoru vytvořené sp_cursoropen uloženou procedurou. sp_cursoroption se vyvolá zadáním ID = 8 v paketu TDS (Tabular Data Stream).

Transact-SQL konvence syntaxe

Syntax

sp_cursoroption cursor , code , value
[ ; ]

Argumenty

Důležitý

Argumenty rozšířených uložených procedur musí být zadány v určitém pořadí, jak je popsáno v části Syntaxe. Pokud jsou parametry zadány mimo pořadí, dojde k chybové zprávě.

kurzoru

Hodnota handle vygenerovaná SQL Serverem a vrácená sp_cursoropen uloženou procedurou. Parametr kurzoru je int a nemůže být NULL.

kódu

Používá se ke stanovení různých faktorů návratových hodnot kurzoru. Parametr kódu je inta musí být jednou z následujících hodnot:

Hodnota Jméno Popis
0x0001 TEXTPTR_ONLY Vrátí textový ukazatel, nikoli skutečná data pro určité určené sloupce textu nebo obrázku.

TEXTPTR_ONLY umožňuje použití textových ukazatelů jako popisovačů k objektům blob, které lze později selektivně načíst nebo aktualizovat pomocí Transact-SQL nebo zařízení DBLIB (například Transact-SQL READTEXT nebo DBLIB DBWRITETEXT).
Pokud je přiřazena 0 hodnota, vrátí všechny sloupce textu a obrázku ve vybraném seznamu textové ukazatele místo dat.
0x0002 CURSOR_NAME Přiřadí název zadaný v hodnotě kurzoru, což umožňuje rozhraní ODBC používat Transact-SQL umístěné UPDATE/DELETE příkazy na kurzorech otevřených prostřednictvím sp_cursoropen.

Řetězec lze zadat jako libovolný znak nebo datový typ Unicode.
Vzhledem k tomu, že Transact-SQL umístěné příkazy UPDATE/DELETE fungují ve výchozím nastavení na prvním řádku tukového kurzoru, sp_cursor SETPOSITION by se měly použít k umístění kurzoru před vystavením umístěného příkazu UPDATE/DELETE.
0x0003 TEXTDATA Vrátí skutečná data, nikoli textový ukazatel, pro určité sloupce textu nebo obrázku při následných načteních (to znamená, že vrátí zpět účinek TEXTPTR_ONLY).

Pokud je pro konkrétní sloupec povolená TEXTDATA, řádek se znovu načte nebo aktualizuje a pak se dá nastavit zpět na TEXTPTR_ONLY. Stejně jako u TEXTPTR_ONLYje parametr hodnoty celé číslo, které určuje číslo sloupce a nulová hodnota vrátí všechny sloupce textu nebo obrázku.
0x0004 SCROLLOPT Možnost posouvání Další informace naleznete v tématu návratové hodnoty kódu.
0x0005 CCOPT Možnost řízení souběžnosti Další informace naleznete v tématu návratové hodnoty kódu.
0x0006 ROWCOUNT Početřádkůch

Poznámka:ROWCOUNT se může změnit od hodnoty vrácené sp_cursoropen, pokud se používá asynchronní soubor. Pokud je počet řádků neznámý, vrátí se hodnota -1.

hodnoty

Určuje hodnotu vrácenou kódem . hodnota je povinný parametr, který volá 0x0001, 0x0002nebo 0x0003kód vstupní hodnotu.

kód hodnota 2 je datový typ řetězce. Jakýkoli jiný kód vstupu nebo vrácený hodnotou je int.

Návratové hodnoty kódu

Parametr hodnoty může vrátit jednu z následujících hodnot kódu.

Návratová hodnota Popis
0x0004 SCROLLOPT
0X0005 CCOPT
0X0006 ROWCOUNT

Parametr hodnoty vrátí jednu z následujících hodnot SCROLLOPT.

Návratová hodnota Popis
0x0001 KEYSET
0x0002 DYNAMIC
0x0004 FORWARD_ONLY
0x0008 STATIC

Parametr hodnoty vrátí jednu z následujících hodnot CCOPT.

Návratová hodnota Popis
0x0001 READ_ONLY
0x0002 SCROLL_LOCKS
0x0004 or 0x0008 OPTIMISTIC

Související obsah