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.
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.
Uwaga:
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 |
Zobacz także
.gif)