TEXTVALID (Transact-SQL)

發行項
03/07/2014

檢查特定文字指標是否有效的 text、ntext 或 image 函數。

重要事項
未來的 Microsoft SQL Server 版本將移除這項功能。請避免在新的開發工作中使用這項功能，並規劃修改目前使用這項功能的應用程式。無法使用替代功能。

適用於：SQL Server (SQL Server 2008 至目前版本)。

主題連結圖示 Transact-SQL 語法慣例

語法

TEXTVALID ( 'table.column' ,text_ ptr )

引數

table
這是將使用的資料表名稱。
column
這是將使用的資料行名稱。
text_ptr
這是將檢查的文字指標。

傳回類型

int

備註

如果指標有效，便傳回 1，如果指標無效，便傳回 0。請注意，text 資料行的識別碼必須包括資料表名稱。如果有效的文字指標不存在，您便無法使用 UPDATETEXT、WRITETEXT 或 READTEXT。

另外，當您使用 text、ntext 和 image 資料時，下列函數和陳述式也很有用。

函數或陳述式	說明
PATINDEX('%pattern%' , expression)	傳回指定字元字串在 text 和 ntext 資料行中的字元位置。
DATALENGTH(expression)	傳回 text、ntext 和 image 資料行中的資料長度。
SET TEXTSIZE	傳回 SELECT 陳述式所要傳回的 text、ntext 或 image 資料的限制 (以位元組為單位)。

範例

下列範例報告 pub_info 資料表之 logo 資料行中的每個值，是否存在有效的文字指標。

注意

若要執行這個範例，您必須安裝 pubs 資料庫。

USE pubs;
GO
SELECT pub_id, 'Valid (if 1) Text data' 
   = TEXTVALID ('pub_info.logo', TEXTPTR(logo)) 
FROM pub_info
ORDER BY pub_id;
GO

以下為結果集：

pub_id Valid (if 1) Text data 
------ ---------------------- 
0736   1                      
0877   1                      
1389   1                      
1622   1                      
1756   1                      
9901   1                      
9952   1                      
9999   1                      

(8 row(s) affected)