Funções de texto e imagem – TEXTVALID (Transact-SQL)

Aplica-se a:SQL ServerInstância Gerenciada de SQL do Azure

Uma função text, ntext ou image que verifica se um ponteiro de texto específico é válido.

Importante

Esse recurso será removido em uma versão futura do SQL Server. Evite usar esse recurso em desenvolvimentos novos e planeje modificar os aplicativos que atualmente o utilizam. A funcionalidade alternativa não está disponível.

Convenções de sintaxe de Transact-SQL

Sintaxe

TEXTVALID ( 'table.column' ,text_ ptr )  

Observação

Para exibir a sintaxe do Transact-SQL para o SQL Server 2014 (12.x) e versões anteriores, confira a Documentação das versões anteriores.

Argumentos

table
É o nome da tabela que será usada.

column
É o nome da coluna que será usada.

text_ptr
É o ponteiro de texto a ser verificado.

Tipos de retorno

int

Comentários

Retorna 1 se o ponteiro for válido e 0 se o ponteiro não for válido. Observe que o identificador para a coluna text deve incluir o nome da tabela. Não é possível usar UPDATETEXT, WRITETEXT ou READTEXT sem um ponteiro de texto válido.

As seguintes funções e instruções também são úteis quando você trabalha com os dados text, ntext e image.

Função ou instrução	Descrição
PATINDEX ( ' %pattern% ' , expressão )	Retorna a posição de caractere de uma cadeia de caracteres especificada nas colunas text e ntext.
DATALENGTH ( expressão )	Retorna o comprimento dos dados nas colunas text, ntext e image.
SET TEXTSIZE	Retorna o limite, em bytes, dos dados text, ntext ou image a serem retornados com uma instrução SELECT.

Exemplos

O exemplo a seguir informa se um ponteiro de texto válido existe para cada valor na coluna logo da tabela pub_info.

Observação

Para executar este exemplo, é necessário instalar o banco de dados 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  

Este é o conjunto de resultados.

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 Também

DATALENGTH (Transact-SQL)
PATINDEX (Transact-SQL)
SET TEXTSIZE (Transact-SQL)
Funções de texto e imagem (Transact-SQL)
TEXTPTR (Transact-SQL)