TEXTVALID (Transact-SQL)

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

Observação importanteImportante

Esse recurso será removido em uma versão futura do Microsoft 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.

Ícone de vínculo de tópicoConvenções de sintaxe Transact-SQL

Sintaxe

TEXTVALID ( 'table.column' ,text_ ptr )

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 funções e instruções a seguir também são úteis para trabalhar com dados de text, ntexte image.

Função ou instrução

Descrição

PATINDEX('%pattern%', expression)

Retorna a posição de caracteres de uma cadeia de caracteres especificada nas colunas text ou ntext.

DATALENGTH(expression)

Retorna o comprimento de dados nas colunas text, ntexte image.

SET TEXTSIZE

Retorna o limite, em bytes, dos dados text, ntextou 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çãoObservação

Para executar este exemplo, é necessário instalar o banco de dados pubs. Para obter informações sobre como instalar o banco de dados pubs, consulte Baixando os bancos de dados de exemplo Northwind e 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

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)