Fonctions texte et image - TEXTVALID (Transact-SQL)

S’applique à :SQL ServerAzure SQL Managed Instance

Fonction text, ntext ou image qui vérifie si un pointeur de texte spécifique est valide.

Important

Cette fonctionnalité sera supprimée dans une version future de SQL Server. Évitez d'utiliser cette fonctionnalité dans de nouveaux travaux de développement, et prévoyez de modifier les applications qui utilisent actuellement cette fonctionnalité. Aucune fonctionnalité de remplacement n'est disponible.

Conventions de la syntaxe Transact-SQL

Syntaxe

TEXTVALID ( 'table.column' ,text_ ptr )  

Remarque

Pour afficher la syntaxe Transact-SQL pour SQL Server 2014 (12.x) et versions antérieures, consultez la Documentation sur les versions antérieures.

Arguments

table
Nom de la table à utiliser.

column
Nom de la colonne à utiliser.

text_ptr
Pointeur texte à vérifier.

Types de retour

int

Notes

Retourne 1 si le pointeur est valide et 0 si le pointeur n'est pas valide. Notez que l’identificateur de la colonne text doit inclure le nom de la table. Vous ne pouvez pas utiliser UPDATETEXT, WRITETEXT ou READTEXT sans pointeur de texte valide.

Les fonctions et instructions suivantes sont également utiles lorsque vous travaillez avec des données text, ntext et image.

Fonction ou instruction	Description
PATINDEX ( ' %pattern% ' , expression )	Retourne la position d’un caractère dans la chaîne de caractères spécifiée dans les colonnes text et ntext.
DATALENGTH ( expression )	Retourne la longueur des données dans les colonnes de type text, ntext et image.
SET TEXTSIZE	Retourne la limite, en octets, des données text, ntext ou image à retourner avec une instruction SELECT.

Exemples

L'exemple suivant indique si un pointeur de texte valide existe pour chaque valeur dans la colonne logo de la table pub_info.

Notes

Pour exécuter cet exemple, vous devez installer la base de données 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  

Voici le jeu de résultats obtenu.

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)  

Voir aussi

DATALENGTH (Transact-SQL)
PATINDEX (Transact-SQL)
SET TEXTSIZE (Transact-SQL)
Fonctions texte et image (Transact-SQL)
TEXTPTR (Transact-SQL)