readtext (Transact-sql)

Okur text, ntext, ya imagegelen değerleri bir text, ntext, ya imagesütununda belirtilen bir ofset ve belirtilen bayt sayısını okumaya.

Önemli notÖnemli

Bu özellik Microsoft SQL Server'ın ilerideki bir sürümünde kaldırılacaktır. Yeni geliştirme işlerinde bu özelliği kullanmaktan kaçının ve bu özelliği kullanmakta olan uygulamalarda değişiklik yapmayı planlayın.Kullanım alt yerine çalışması.

Konu bağlantısı simgesi Transact-SQL Sözdizim Kuralları

Sözdizimi

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

Bağımsız değişkenler

  • table**.**column
    Bir tablo ve okumak sütun addır. Tablo ve sütun adlarını gerekir uymak için kurallar ile tanımlayıcıları. Tablo ve sütun adlarını belirtmek gereklidir; Ancak, sahibinin adı ve veritabanı adı belirtmek isteğe bağlıdır.

  • text_ptr
    Geçerli metin imleci olduğunu. text_ptrmust be binary(16).

  • offset
    Bayt sayısı (ne zaman textveya imageveri türleri kullanılır) veya karakter (zaman ntextveri türü kullanılır) okumaya başlamadan önce geçmek için text, image, veya ntextveri.

  • size
    Bayt sayısı (ne zaman textya imageveri türleri kullanılır) veya karakter (ne zaman ntextveri türü kullanılır) veri okumak için. Eğer size0, 4 kb bayt veri okumak.

  • HOLDLOCK
    Metin değeri işlemin sonuna kadar okur için kilitlenmesine neden olur. Diğer kullanıcıların değerini okuyabilir, ancak onu değiştiremez.

Açıklamalar

Kullanım textptr işlevi geçerli bir edinmek için text_ptrdeğer. textptr işlevi için bir işaretçi text, ntext, ya imagesütun belirtilen satırın veya e text, ntext, ya imagebirden fazla satır döndürülürse sorgu tarafından döndürülen son satırda sütuna. textptr 16 bayt ikili dize verdiğinden, metin imleci tutmak için yerel bir değişken bildirme tavsiye ve değişken readtext ile kullanın. Yerel bir değişken bildirme hakkında daha fazla bilgi için bkz: DECLARE @local\_variable (Transact-SQL).

De SQL Server, satır metin işaretçiler bulunabilir ancak geçerli olmayabilir. Hakkında daha fazla bilgi için satır metni seçeneği, bakın sp_tableoption (Transact-sql). Metin işaretçiler geçersiz kılmalarını hakkında daha fazla bilgi için bkz: sp_invalidate_textptr (Transact-sql).

@@ TEXTSIZE işlevi değeri o readtext için belirtilen boyuttan daha küçükse readtext için belirtilen boyutta yerini alır. @@ TEXTSIZE işlevi, veri kümesi set TEXTSIZE deyimi tarafından döndürülen bayt sayısı üst sınırını belirtir. Oturum ayarı için TEXTSIZE ayarlama hakkında daha fazla bilgi için bkz: set TEXTSIZE (Transact-sql).

İzinler

readtext belirtilen tablo üzerinde select izinlerine sahip kullanıcılar için varsayılan izinleri. select izinleri aktarıldığında izinleri devredilemez.

Örnekler

Aşağıdaki örnek üzerinden yirmi altıncı karakterden ikinci okur pr_infosütununda pub_infotablosu.

[!NOT]

Bu örneği çalıştırmak için önce yüklemeniz gerekir pub örnek veritabanı.

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

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

Ayrıca bkz.

Başvuru

@@ TEXTSIZE (Transact-sql)

updatetext (Transact-sql)

WRITETEXT (Transact-sql)