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’information: Filtrer les lignes à l’aide de QueryExpression

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 premier plan

Requêtes qui utilisent des opérateurs de condition avec des caractères génériques implicites (comme ends-with) ou des caractères joker explicites seront moins performants et peuvent conduire à de mauvaises performances dans l’ensemble de l’organisation dans certains scénarios. Pour plus d’informations :

• Optimiser les performances à l’aide de FetchXml
• Optimiser les performances à l’aide de QueryExpression

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

FetchXml

N’utilisez pas de caractères génériques de fin dans les expressions utilisant like, 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='like' value='%value' />
<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 début dans les expressions utilisant Like, BeginsWith, DoesNotBeginWith, EndsWith ou DoesNotEndWith. Exemples des caractères spéciaux excessifs :

Exemples incorrects
query.Criteria.AddCondition("name", ConditionOperator.Like, "%value");
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 début dans les expressions utilisant like, startswith, not startswith, endswith ou not endswith. Exemples des caractères spéciaux excessifs :

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

Voir aussi

Filtrer des lignes à l’aide de FetchXml
Filtrer les lignes à l’aide de QueryExpression
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é).