TEXTVALID (Transact-SQL)

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 prochaine version de Microsoft 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.

Icône Lien de rubriqueConventions de la syntaxe de Transact-SQL

Syntaxe

TEXTVALID ( 'table.column' ,text_ ptr )

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 ci-après sont également utiles pour la manipulation 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 des colonnes text et ntext.

DATALENGTH(expression)

Retourne la longueur des données des colonnes text, ntext et image.

SET TEXTSIZE

Retourne la limite, en octets, des données text, ntext ou image à retourner avec une instruction SELECT.

Exemple

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

[!REMARQUE]

Pour exécuter cet exemple, vous devez installer la base de données pubs. Pour plus d'informations sur l'installation de la base de données pubs, consultez Téléchargement des exemples de bases de données Northwind et 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 l'ensemble des résultats.

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)