Udostępnij za pośrednictwem

sp_cursoroption (Transact-SQL)

  • Artykuł

Dotyczy:programu SQL Server

Ustawia opcje kursora lub zwraca informacje o kursorze utworzone przez procedurę składowaną sp_cursoropen. sp_cursoroption jest wywoływana przez określenie ID = 8 w pakiecie strumienia danych tabelarycznych (TDS).

Transact-SQL konwencje składni

Składnia

sp_cursoroption cursor , code , value
[ ; ]

Argumenty

Ważny

Argumenty dla rozszerzonych procedur składowanych należy wprowadzić w określonej kolejności zgodnie z opisem w sekcji składni. Jeśli parametry są wprowadzane poza kolejnością, wystąpi komunikat o błędzie.

kursora

Wartość handle wygenerowana przez program SQL Server i zwrócona przez procedurę składowaną sp_cursoropen. Parametr kursora jest i nie może być NULL.

kodu

Służy do określania różnych czynników zwracanych wartości kursora. Parametr kodu jest inti musi być jedną z następujących wartości:

Wartość Nazwa Opis
0x0001 TEXTPTR_ONLY Zwraca wskaźnik tekstowy, a nie rzeczywiste dane dla określonych kolumn tekstowych lub obrazów.

TEXTPTR_ONLY umożliwia używanie wskaźników tekstowych jako dojścia do obiektów blob, które można później selektywnie pobierać lub aktualizować przy użyciu obiektów Transact-SQL lub DBLIB (na przykład Transact-SQL READTEXT lub DBLIB DBWRITETEXT).
Jeśli zostanie przypisana 0 wartość, wszystkie kolumny tekstowe i kolumny obrazu na liście zaznaczenia zwracają wskaźniki tekstowe, a nie dane.
0x0002 CURSOR_NAME Przypisuje nazwę określoną w wartości do kursora, co umożliwia odBC używanie Transact-SQL umieszczonych instrukcji UPDATE/DELETE na kursorach otwartych za pośrednictwem sp_cursoropen.

Ciąg można określić jako dowolny znak lub typ danych Unicode.
Ponieważ Transact-SQL umieszczone instrukcje UPDATE/DELETE działają domyślnie, w pierwszym wierszu kursora tłuszczu, sp_cursor SETPOSITION należy użyć do pozycjonowania kursora przed wydaniem umieszczonej instrukcji UPDATE/DELETE.
0x0003 TEXTDATA Zwraca rzeczywiste dane, a nie wskaźnik tekstowy dla niektórych kolumn tekstowych lub obrazów w kolejnych pobieraniu (oznacza to, że powoduje to cofnięcie wpływu TEXTPTR_ONLY).

Jeśli TEXTDATA jest włączona dla określonej kolumny, wiersz zostanie ponownie pobrany lub odświeżony, a następnie można go ustawić z powrotem na TEXTPTR_ONLY. Podobnie jak w przypadku TEXTPTR_ONLY, parametr value jest liczbą całkowitą określającą liczbę kolumn, a wartość zero zwraca wszystkie kolumny tekstowe lub obrazy.
0x0004 SCROLLOPT Opcja przewijania. Aby uzyskać więcej informacji, zobacz Zwracanie wartości kodu.
0x0005 CCOPT Opcja kontroli współbieżności. Aby uzyskać więcej informacji, zobacz Zwracanie wartości kodu.
0x0006 ROWCOUNT Liczba wierszy aktualnie w zestawie wyników.

Uwaga:ROWCOUNT mogła ulec zmianie od czasu użycia wartości zwróconej przez sp_cursoropen, jeśli jest używana populacja asynchroniczna. Wartość -1 jest zwracana, jeśli liczba wierszy jest nieznana.

wartości

Wyznacza wartość zwracaną przez kod . wartość jest wymaganym parametrem wywołującym wartość wejściową 0x0001, 0x0002lub 0x0003kodu.

Kod wartość 2 jest typem danych ciągu. Każdy inny kod wartość wejściową lub zwracany przez wartość jest int.

Zwracanie wartości kodu

Wartość parametru może zwrócić jedną z następujących wartości kodu.

Wartość zwracana Opis
0x0004 SCROLLOPT
0X0005 CCOPT
0X0006 ROWCOUNT

Wartość parametr zwraca jedną z następujących wartości SCROLLOPT.

Wartość zwracana Opis
0x0001 KEYSET
0x0002 DYNAMIC
0x0004 FORWARD_ONLY
0x0008 STATIC

Wartość parametr zwraca jedną z następujących wartości CCOPT.

Wartość zwracana Opis
0x0001 READ_ONLY
0x0002 SCROLL_LOCKS
0x0004 or 0x0008 OPTIMISTIC

Powiązana zawartość