Utilisez des caractères génériques dans les conditions pour les valeurs de chaîne

Vous pouvez utiliser des caractères génériques avec les opérateurs suivants lorsque vous créez des requêtes utilisant des conditions sur des valeurs de chaîne :

FetchXml

like
not-like
begins-with
not-begin-with
ends-with
not-end-with

Plus d’informations : Interroger des données à l’aide de FetchXml

QueryExpression

ConditionOperator. Like
ConditionOperator. NotLike
ConditionOperator. BeginsWith
ConditionOperator. DoesNotBeginWith
ConditionOperator. EndsWith
ConditionOperator. DoesNotEndWith

Plus d’informations : Utiliser la classe ConditionExpression

API web

contains
not contains
startswith
not startswith
endswith
not endswith

Plus d’informations : Utiliser les fonctions de requête OData

Lorsque vous utilisez ces opérateurs de condition, vous pouvez utiliser certains caractères pour représenter des caractères génériques dans vos critères de recherche. La table suivante décrit les caractères que vous pouvez utiliser.

Caractères	Description	Documentation T-SQL et exemples
%	Correspond à n’importe quelle chaîne de zéro ou plusieurs caractères. Ce caractère générique peut être utilisé comme préfixe ou comme suffixe.	Caractère de pourcentage (caractère générique – Caractère(s) à faire correspondre) (Transact-SQL)
_	Correspond à n’importe quel caractère unique dans une opération de comparaison de chaînes qui implique une correspondance de modèle.	_ (Caractère générique – Correspond à un caractère) (Transact-SQL)
[]	Correspond à n’importe quel caractère unique hors de la plage ou l’ensemble spécifié qui est spécifié entre crochets.	[ ] (Caractère générique – Caractère(s) à faire correspondre) (Transact-SQL)
[^]	Correspond à n’importe quel caractère unique hors de la plage ou l’ensemble spécifié qui est spécifié entre crochets.	[^] (Caractère générique – Caractère(s) à ne pas faire correspondre) (Transact-SQL)

Rechercher des chaînes contenant des caractères génériques

Vous pouvez utiliser les caractères génériques correspondant au modèle comme caractères littéraux. Pour utiliser un caractère générique comme caractère littéral, placez le caractère générique entre crochets. Plus d’informations : Utilisation de caractères génériques comme littéraux.

N’utilisez pas de caractères génériques de fin

L’utilisation de caractères génériques de fin n’est pas prise en charge.

FetchXml

N’utilisez pas de caractères génériques de fin dans les expressions utilisant begins-with, not-begin-with, ends-with ou not-end-with. Voici quelques exemples de caractères génériques de fin :

Exemples incorrects
<condition attribute='name' operator='begins-with' value='%value' />
<condition attribute='name' operator='not-begins-with' value='%value' />
<condition attribute='name' operator='ends-with' value='value%' />
<condition attribute='name' operator='not-ends-with' value='value%' />

QueryExpression

N’utilisez pas de caractères génériques de fin dans les expressions utilisant BeginsWith, DoesNotBeginWith, EndsWith ou DoesNotEndWith. Voici quelques exemples de caractères génériques de fin :

Exemples incorrects
query.Criteria.AddCondition("name", ConditionOperator.BeginsWith, "%value");
query.Criteria.AddCondition("name", ConditionOperator.DoesNotBeginWith, "%value");
query.Criteria.AddCondition("name", ConditionOperator.EndsWith, "value%");
query.Criteria.AddCondition("name", ConditionOperator.DoesNotEndWith, "value%");

API web

N’utilisez pas de caractères génériques de fin dans les expressions utilisant startswith, not startswith, endswith ou not endswith. Voici quelques exemples de caractères génériques de fin :

Exemples incorrects
startswith(name,'%value')
not startswith(name,'%value')
endswith(name,'value%')
not endswith(name,'value%')

Les requêtes utilisant ces anti-modèles introduisent des problèmes de performances car les requêtes ne peuvent pas être optimisées.

Voir aussi

Interroger des données à l’aide de FetchXml
Utiliser la classe ConditionExpression
Interroger les données à l’aide de l’API web

Notes

Pouvez-vous nous indiquer vos préférences de langue pour la documentation ? Répondez à un court questionnaire. (veuillez noter que ce questionnaire est en anglais)

Le questionnaire vous prendra environ sept minutes. Aucune donnée personnelle n’est collectée (déclaration de confidentialité).