Udostępnij przez


sp_cursoroption (języka Transact-SQL)

Ustawia opcje kursor lub zwraca informacje kursor utworzony przez sp_cursoropen procedura składowana.sp_cursoroption is invoked by specifying ID =8 in a tabular data stream (TDS) packet.

Ikona łącza do tematuJęzyka Transact-SQL składni konwencje

Składnia

sp_cursoroption cursor, code, value

Argumenty

  • cursor
    Jest dojście wartość, która jest generowana przez SQL Server i zwrócone przez sp_cursoropen procedura składowana.cursorwymaga int wartości wejściowej dla realizacji.

  • code
    Można zastrzec, że różne czynniki kursor zwracają wartości.codewymaga jednego z następujących int wartości wejściowe:

    Wartość

    Nazwa

    Opis

    0X0001

    TEXTPTR_ONLY

    Zwraca kursor tekstowy, a nie rzeczywiste dane, dla niektórych wyznaczonych tekstu lub obrazu kolumn.

    TEXTPTR_ONLY pozwala wskaźniki tekstowe mają być używane jako uchwyty do obiektów blob , które później mogą być pobierane selektywnie lub zaktualizowane przy użyciu Transact-SQL lub DBLIB urządzeń (np Transact-SQL READTEXT lub DBLIB DBWRITETEXT).

    Jeśli "0" przypisana wartość cały tekst i obraz kolumn na liście select zwróci wskaźniki tekstu, a nie dane.

    0X0002

    CURSOR_NAME

    Przypisuje nazwę określoną w value kursor.To z kolei umożliwia ODBC za pomocą Transact-SQL umieszczony instrukcji UPDATE i DELETE na kursory otwierane za pomocą sp_cursoropen.

    ciąg może być określona jako dowolny znak lub typ danych Unicode.

    Ponieważ Transact-SQL pozycjonowane instrukcji UPDATE i DELETE działa domyślnie na pierwszy wiersz w tłuszczu kursor sp_cursor SETPOSITION powinna być używana do Umieść kursor przed wydaniem pozycjonowane UPDATE i DELETE instrukcja.

    0x0003

    TEXTDATA

    Zwraca dane rzeczywiste, nie wskaźnik tekstu, dla niektórych kolumn tekstu lub obrazu na kolejne pobiera (tj.Spowoduje to cofnięcie efekt TEXTPTR_ONLY).

    TEXTDATA jest włączone dla określonej kolumna wiersza jest re-fetched lub odświeżane, a następnie można zestaw na TEXTPTR_ONLY.Z TEXTPTR_ONLY, wartość parametru jest liczba całkowita, która określa numer kolumna , a wszystkie kolumny tekstu lub obrazu zwraca wartość zero.

    0X0004

    SCROLLOPT

    Przewiń listę opcji.Zobacz temat "Zwrócony kod wartości" w dalszej części tego tematu, aby uzyskać dodatkowe informacje.

    0x0005

    CCOPT

    Opcja sterowania współbieżności.Zobacz temat "Zwrócony kod wartości" w dalszej części tego tematu, aby uzyskać dodatkowe informacje.

    0x0006

    ROWCOUNT

    Liczba wierszy znajdujących się aktualnie w zestaw wyników.

    UwagaUwaga:
    ROWCOUNT może zmieniły się od wartości zwróconej przez sp_cursoropen Jeżeli zastosowano asynchronicznego zapełnianie .Jeśli liczba wierszy jest nieznana, zwracana jest wartość-1.
  • value
    Wyznacza wartość zwracana przez code.valuejest wymagany parametr, który wywołuje 0x0001, 0x0002 lub 0x0003 code wartości wejściowych.

    Ostrzeżenie

    A code wartość 2 jest typ danych ciąg .Inne code wartości wejściowych lub zwrócony przez value jest liczbą całkowitą.

Wartości kodów powrotnych

value Parametr może zwrócić jeden z następujących code wartości.

Zwracanie wartości

Opis

0X0004

SCROLLOPT

0X0005

CCOPT

0X0006

ROWCOUNT

value Parametr zwraca jedną z wartości SCROLLOPT.

Zwracanie wartości

Opis

0X0001

ZESTAW KLUCZY

0X0002

DYNAMICZNE

0X0004

FORWARD_ONLY

0X0008

STATYCZNE

value Parametr zwraca jedną z wartości CCOPT.

Zwracanie wartości

Opis

0X0001

TYLKO_DO_ODCZYTU

0X0002

SCROLL_LOCKS

0X0004 lub 0x0008

PRZYPADEK OPTYMISTYCZNY