TEXTPTR (Transact-SQL)

返回对应于 varbinary 格式的 text、ntext 或 image 列的文本指针值。检索到的文本指针值可用于 READTEXT、WRITETEXT 和 UPDATETEXT 语句。

重要提示：
后续版本的 Microsoft SQL Server 将删除该功能。请避免在新的开发工作中使用该功能，并着手修改当前还在使用该功能的应用程序。 没有可用的替代功能。

Transact-SQL 语法约定

语法

TEXTPTR ( column )

参数

column

将要使用的 text、ntext 或 image 列。

返回类型

varbinary

备注

在 SQL Server 2005 中，对于含行内文本的表，TEXTPTR 将为要处理的文本返回一个句柄。即使文本值为空，仍可获得有效的文本指针。

在 SQL Server 2005 中，不能对视图列使用 TEXTPTR 函数，只能对表列使用此函数。若要在视图列使用 TEXTPTR 函数，必须使用 sp_dbcmptlevel 将兼容级别设置为 80。

如果表不含行内文本，并且 text、ntext 或 image 列沿未使用 UPDATETEXT 语句初始化，则 TEXTPTR 将返回一个空指针。

可使用 TEXTVALID 来测试文本指针是否存在。如果没有有效的文本指针，则无法使用 UPDATETEXT、WRITETEXT 或 READTEXT。

使用 text、ntext 和 image 数据时，这些函数和语句也很有用。

函数或语句	说明
PATINDEX('%pattern%' , expression)	返回指定字符串在 text 或 ntext 列中的字符位置。
DATALENGTH(expression)	返回 text、ntext 和 image 列中数据的长度。
SET TEXTSIZE	返回对 SELECT 语句所返回的 text、ntext 或 image 数据的限制（字节）。
SUBSTRING(text_column, start, length)	返回由指定的 start 偏移量和 length 指定的 varchar 字符串。字符串的长度应小于 8 KB。

示例

注意：
若要运行以下示例，必须安装 pubs 数据库。有关如何安装 pubs 数据库的信息，请参阅下载 Northwind 和 pubs 示例数据库。

A. 使用 TEXTPTR

以下示例将使用 TEXTPTR 函数来查找与 pubs 数据库的 pub_info 表中的 New Moon Books 关联的 image 列 logo。文本指针放在局部变量 @ptrval. 中。

USE pubs
GO
DECLARE @ptrval varbinary(16)
SELECT @ptrval = TEXTPTR(logo) 
FROM pub_info pr, publishers p
WHERE p.pub_id = pr.pub_id 
   AND p.pub_name = 'New Moon Books'
GO

B. 将 TEXTPTR 用于行内文本

在 SQL Server 中，必须在以下示例所示的事务中使用行内文本指针。

CREATE TABLE t1 (c1 int, c2 text)
EXEC sp_tableoption 't1', 'text in row', 'on'
INSERT t1 VALUES ('1', 'This is text.')
GO
BEGIN TRAN
   DECLARE @ptrval VARBINARY(16)
   SELECT @ptrval = TEXTPTR(c2)
   FROM t1
   WHERE c1 = 1
   READTEXT t1.c2 @ptrval 0 1
COMMIT

C. 返回文本数据

以下示例将从 pub_info 表中选择 pub_id 列和 pr_info 列的 16 字节文本指针。

USE pubs
GO
SELECT pub_id, TEXTPTR(pr_info)
FROM pub_info
ORDER BY pub_id
GO

下面是结果集： 

pub_id                                    
------ ---------------------------------- 
0736   0x6c0000000000feffb801000001000100 
0877   0x6d0000000000feffb801000001000300 
1389   0x6e0000000000feffb801000001000500 
1622   0x700000000000feffb801000001000900 
1756   0x710000000000feffb801000001000b00 
9901   0x720000000000feffb801000001000d00 
9952   0x6f0000000000feffb801000001000700 
9999   0x730000000000feffb801000001000f00 

(8 row(s) affected)

以下示例显示如何在不使用 TEXTPTR 的情况下，返回文本的前 8000 个字节。

USE pubs
GO
SET TEXTSIZE 8000
SELECT pub_id, pr_info
FROM pub_info
ORDER BY pub_id
GO

下面是结果集： 

pub_id pr_info                                                                                                                                                                                                                                                         
------ -----------------------------------------------------------------
0736   New Moon Books (NMB) has just released another top ten publication. With the latest publication this makes NMB the hottest new publisher of the year!                                                                                                           
0877   This is sample text data for Binnet & Hardley, publisher 0877 in the pubs database. Binnet & Hardley is located in Washington, D.C.

This is sample text data for Binnet & Hardley, publisher 0877 in the pubs database. Binnet & Hardley is located in Washi 
1389   This is sample text data for Algodata Infosystems, publisher 1389 in the pubs database. Algodata Infosystems is located in Berkeley, California.

9999   This is sample text data for Lucerne Publishing, publisher 9999 in the pubs database. Lucerne publishing is located in Paris, France.

This is sample text data for Lucerne Publishing, publisher 9999 in the pubs database. Lucerne publishing is located in 

(8 row(s) affected)

D. 返回特定文本数据

以下示例将查找与 pubs 数据库的 pub_info 表中的 pub_id``0736 关联的 text 列 (pr_info)。该例首先声明了一个局部变量 @val。然后，将文本指针（长二进制字符串）置于 @val 中，并将其作为参数提供给 READTEXT 语句。结果将返回从第五个字节（偏移量为 4）开始的 10 个字节。

USE pubs
GO
DECLARE @val varbinary(16)
SELECT @val = TEXTPTR(pr_info) 
FROM pub_info
WHERE pub_id = '0736'
READTEXT pub_info.pr_info @val 4 10
GO

下面是结果集： 

pr_info                                                                                                                                                                                                                                                         
-----------------------------------------------------------------------
 is sample
(1 row(s) affected)

请参阅

参考

DATALENGTH (Transact-SQL)
PATINDEX (Transact-SQL)
READTEXT (Transact-SQL)
SET TEXTSIZE (Transact-SQL)
文本与图像函数 (Transact-SQL)
UPDATETEXT (Transact-SQL)
WRITETEXT (Transact-SQL)

帮助和信息

获取 SQL Server 2005 帮助