Text 和 Image 函式 - TEXTVALID (Transact-SQL)

適用於：SQL ServerAzure SQL 受控執行個體

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

重要

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

Transact-SQL 語法慣例

Syntax

TEXTVALID ( 'table.column' ,text_ ptr )  

注意

若要檢視 SQL Server 2014 （12.x） 和舊版的 Transact-SQL 語法，請參閱 舊版檔。

引數

table
這是將使用的資料表名稱。

column
這是將使用的資料行名稱。

text_ptr
這是將檢查的文字指標。

傳回型別

int

備註

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

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

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

範例

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

注意

若要執行這個範例，您必須安裝 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)  

另請參閱

DATALENGTH (Transact-SQL)
PATINDEX (Transact-SQL)
SET TEXTSIZE (Transact-SQL)
Text 和 Image 函數 (Transact-SQL)
TEXTPTR (Transact-SQL)