• Articolo

TEXTVALID (Transact-SQL)

Funzione text, ntext o image che controlla se un puntatore di testo specifico è valido.

Nota importanteImportante

Questa caratteristica verrà rimossa a partire da una delle prossime versioni di Microsoft SQL Server. Evitare di utilizzare questa funzionalità in un nuovo progetto di sviluppo e prevedere interventi di modifica nelle applicazioni in cui è attualmente implementata. Non è disponibile una funzionalità alternativa.

Icona di collegamento a un argomentoConvenzioni della sintassi Transact-SQL

Sintassi

TEXTVALID ( 'table.column' ,text_ ptr )

Argomenti

  • table
    Nome della tabella che si desidera utilizzare.

  • column
    Nome della colonna che si desidera utilizzare.

  • text_ptr
    Puntatore di testo che si desidera controllare.

Tipi restituiti

int

Osservazioni

Restituisce 1 se il puntatore è valido e 0 in caso contrario. Si noti che l'identificatore per la colonna di tipo text deve includere il nome della tabella. Non è possibile utilizzare UPDATETEXT, WRITETEXT o READTEXT senza un puntatore di testo valido.

Per l'utilizzo di dati di tipo text, ntext e image risultano utili anche le funzioni e le istruzioni seguenti.

Funzione o istruzione

Descrizione

PATINDEX('%pattern%', expression)

Restituisce la posizione dei caratteri di una determinata stringa di caratteri nelle colonne di tipo text e ntext

DATALENGTH(expression)

Restituisce la lunghezza dei dati nelle colonne di tipo text, ntext e image.

SET TEXTSIZE

Restituisce il limite, espresso in byte, dei dati di tipo text, ntext o image da restituire con un'istruzione SELECT.

Esempi

Nell'esempio seguente viene stabilito se esiste un puntatore di testo valido per ogni valore della colonna logo della tabella pub_info.

[!NOTA]

Per eseguire l'esempio, è necessario installare il database pubs. Per informazioni sulle procedure di installazione del database pubs, vedere Download dei database di esempio 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

Set di risultati:

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)