Udostępnij za pośrednictwem

  • Artykuł

READTEXT (Transact-SQL)

Odczytuje text, ntext, lub image wartości z text, ntext, lub image kolumna, począwszy od określone przesunięcie i odczytywania określonej liczby bajtów.

Ważna informacjaWażne:

Ta funkcja zostanie usunięta z przyszłej wersji programu Microsoft SQL Server. Należy unikać stosowania tej funkcji w nowych projektach oraz zaplanować modyfikację aplikacji, w których obecnie jest używana ta funkcja.Użycie PODCIĄG funkcja w zamian.

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

Składnia

READTEXT { table.column text_ptr offset size } [ HOLDLOCK ]

Argumenty

  • table**.**column
    Jest nazwą tabela i kolumna , z której do odczytu.Nazwy tabel i kolumna muszą być zgodne z zasadami identyfikatorów.Określanie nazw tabela i kolumna jest wymagana; Jednakże podając nazwę bazy danych i nazwy właściciela jest opcjonalne.

  • text_ptr
    Jest wskaźnik prawidłowy tekst.text_ptrmust be binary(16).

  • offset
    Jest liczbą bajtów (po text lub image typy danych są używane) lub znaki (po ntext używany typ danych) pominąć przed uruchomieniem odczytać text, image, lub ntext danych.

  • size
    Jest to liczba bajtów (po text lub image typy danych są używane) lub znaki (po ntext używany typ danych) danych do odczytu.Jeśli size jest równa 0, 4 KB bajtów danych jest odczytu.

  • HOLDLOCK
    Powoduje, że wartość tekstową na zablokowany do odczytów aż do zakończenia transakcji.Inni użytkownicy mogą odczytywać wartość, ale nie mogą go modyfikować.

Uwagi

Użycie TEXTPTR funkcja , aby uzyskać prawidłowy text_ptr wartości.TEXTPTR zwraca wskaźnik text, ntext, lub image kolumna w określonym wierszu lub do text, ntext, lub image kolumna w ostatnim wierszu zwracanych przez kwerendę, jeśli zwracany jest więcej niż jeden wiersz.Ponieważ TEXTPTR zwraca binarny 16-bajtowy ciąg, firma Microsoft zaleca się zadeklarowanie zmiennej lokalnej, przytrzymaj wskaźnik tekstowy, a następnie użyć zmiennej z READTEXT.Aby uzyskać więcej informacji na temat deklarowanie zmiennej lokalnej, zobacz DECLARE @local_variable (Transact-SQL).

W SQL Server, w wierszu tekstu wskaźników może istnieć, ale może być nieprawidłowy.Aby uzyskać więcej informacji o tekstu w wierszu opcji, zobacz sp_tableoption (języka Transact-SQL).Aby uzyskać więcej informacji dotyczących unieważniania wskaźniki tekstu, zobacz sp_invalidate_textptr (języka Transact-SQL).

Wartość @@ TEXTSIZE funkcja zastępuje rozmiar określony dla READTEXT, jeśli jest mniejsza niż określony rozmiar READTEXT.@@ TEXTSIZE funkcja określa limit liczby bajtów danych zwracanych zestaw przez TEXTSIZE z zestawu instrukcja.Aby uzyskać więcej informacji na temat zestaw ustawienia sesja dla TEXTSIZE, zobacz ZESTAW TEXTSIZE (Transact-SQL).

Uprawnienia

READTEXT domyślne uprawnienia dla użytkowników, które mają uprawnienia SELECT w określonej tabela.Uprawnienia są zbywalne, gdy uprawnienie SELECT są przenoszone.

Przykłady

Poniższy przykład odczytuje od drugiego do dwudziestego szóstego znaków pr_info kolumna w pub_info tabela.

Ostrzeżenie

Aby uruchomić ten przykład, należy zainstalować pubs przykładowej bazy danych.Aby uzyskać informacje dotyczące sposobu instalowania pubs przykładowe bazy danych, zobacz Pobieranie Northwind i pubs przykładowe bazy danych.

USE pubs;
GO
DECLARE @ptrval varbinary(16);
SELECT @ptrval = TEXTPTR(pr_info) 
   FROM pub_info pr INNER JOIN publishers p
      ON pr.pub_id = p.pub_id 
      AND p.pub_name = 'New Moon Books'
READTEXT pub_info.pr_info @ptrval 1 25;
GO