Funciones de texto e imagen - TEXTVALID (Transact-SQL)Text and Image Functions - TEXTVALID (Transact-SQL)

SE APLICA A: síSQL Server noAzure SQL Database noAzure SQL Data Warehouse noAlmacenamiento de datos paralelos APPLIES TO: yesSQL Server noAzure SQL Database noAzure SQL Data Warehouse noParallel Data Warehouse

Una función de tipo text, ntext o image que comprueba la validez de un puntero de texto específico.A text, ntext, or image function that checks whether a specific text pointer is valid.

Importante

Esta característica está en modo de mantenimiento y es posible que no se incluya en una versión futura de Microsoft SQL Server.This feature is in maintenance mode and may be removed in a future version of Microsoft SQL Server. Evite utilizar esta característica en nuevos trabajos de desarrollo y tenga previsto modificar las aplicaciones que actualmente la utilizan.Avoid using this feature in new development work, and plan to modify applications that currently use this feature. No hay ninguna funcionalidad alternativa disponible.Alternative functionality is not available.

Icono de vínculo de tema Convenciones de sintaxis de Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SintaxisSyntax

  
TEXTVALID ( 'table.column' ,text_ ptr )  

ArgumentosArguments

tabletable
Es el nombre de la tabla que se va a utilizar.Is the name of the table that will be used.

columncolumn
Es el nombre de la columna que se va a utilizar.Is the name of the column that will be used.

text_ptrtext_ptr
Es el puntero de texto que se va a comprobar.Is the text pointer to be checked.

Tipos devueltosReturn Types

intint

NotasRemarks

Devuelve 1 si el puntero es válido y 0 si no lo es.Returns 1 if the pointer is valid and 0 if the pointer is not valid. Observe que el identificador de la columna de tipo text debe incluir el nombre de la tabla.Note that the identifier for the text column must include the table name. No es posible utilizar UPDATETEXT, WRITETEXT o READTEXT sin un puntero de texto válido.You cannot use UPDATETEXT, WRITETEXT, or READTEXT without a valid text pointer.

Estas funciones e instrucciones son también útiles cuando se trabaja con datos de tipo text, ntext e image.The following functions and statements are also useful when you work with text, ntext, and image data.

Función o instrucciónFunction or statement DescripciónDescription
PATINDEX ( ' %pattern% ' , expression )PATINDEX ('%pattern%', expression) Devuelve la posición de carácter de una cadena de caracteres especificada en columnas de tipo text y ntext.Returns the character position of a specified character string in text and ntext columns.
DATALENGTH ( expression )DATALENGTH (expression) Devuelve la longitud de datos en columnas text, ntext e image.Returns the length of data in text, ntext, and image columns.
SET TEXTSIZESET TEXTSIZE Devuelve el límite en bytes de los datos de tipo text, ntext o image que se devuelven con una instrucción SELECT.Returns the limit, in bytes, of the text, ntext, or image data to be returned with a SELECT statement.

EjemplosExamples

En el siguiente ejemplo se informa acerca de si existe un puntero de texto válido para cada valor de la columna logo de la tabla pub_info.The following example reports whether a valid text pointer exists for each value in the logo column of the pub_info table.

Nota

Para ejecutar este ejemplo, debe instalar la base de datos pubs.To run this example, you must install the pubs database.

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  

El conjunto de resultados es el siguiente.Here is the result set.

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)  

Consulte tambiénSee Also

DATALENGTH (Transact-SQL) DATALENGTH (Transact-SQL)
PATINDEX (Transact-SQL) PATINDEX (Transact-SQL)
SET TEXTSIZE (Transact-SQL) SET TEXTSIZE (Transact-SQL)
Funciones de texto e imagen (Transact-SQL) Text and Image Functions (Transact-SQL)
TEXTPTR (Transact-SQL)TEXTPTR (Transact-SQL)