發行項
09/24/2010

TEXTVALID (Transact-SQL)

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

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

主題連結圖示 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 資料庫。如需有關如何安裝 pubs 資料庫的資訊，請參閱＜下載 Northwind 和 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)