Verwenden Sie Platzhalterzeichen in Bedingungen für Zeichenfolgenwerte

Sie können Platzhalterzeichen mit den folgenden Operatoren verwenden, wenn Sie Abfragen erstellen, die Bedingungen für Zeichenfolgen enthalten:

FetchXML

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

Weitere Informationen: Daten mithilfe von FetchXML abfragen

QueryExpression

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

Weitere Informationen: Zeilen mit QueryExpression filtern

Web-API

contains
not contains
startswith
not startswith
endswith
not endswith

Weitere Informationen: OData-Abfragefunktionen verwenden

Wenn Sie diese Bedingungsoperatoren verwenden, können Sie bestimmte Zeichen verwenden, um Platzhalter in Ihren Suchkriterien darzustellen. In der folgenden Tabelle werden die Zeichen beschrieben, die Sie verwenden können.

Zeichen	Beschreibung	T-SQL-Dokumentation und Beispiele
%	Stimmt mit einer beliebigen Zeichenfolge aus null oder mehr Zeichen überein. Dieses Platzhalterzeichen kann entweder als Präfix oder als Suffix verwendet werden.	Prozentzeichen (Platzhalter – Abzugleichende Zeichen) (Transact-SQL)
_	Passt auf jedes einzelne Zeichen in einer Zeichenfolge in einem Vorgang, der einen Musterabgleich beinhaltet.	_ (Platzhalter – Übereinstimmung mit einem Zeichen) (Transact-SQL)
[]	Passt auf jedes einzelne Zeichen in dem Bereich oder der Menge, der/die zwischen eckigen Klammern angegeben ist.	[ ] (Platzhalter - Übereinstimmende Zeichen) (Transact-SQL)
[^]	Passt auf jedes einzelne Zeichen, das sich nicht in dem Bereich oder der Menge befindet, der/die zwischen den eckigen Klammern angegeben ist.	[^] (Platzhalter - Nicht Übereinstimmende Zeichen) (Transact-SQL)

Suchen Sie nach Zeichenfolgen, die Platzhalterzeichen enthalten

Sie können die Wildcard-Mustervergleichszeichen als Literalzeichen verwenden. Um ein Platzhalterzeichen als Literalzeichen zu verwenden, schließen Sie das Platzhalterzeichen in Klammern ein. Mehr Informationen: Verwenden von Platzhalterzeichen als Literale.

Verwenden Sie keine vorangestellten Platzhalter

Abfragen, die Bedingungsoperatoren mit impliziten vorangestellten Platzhaltern (wie ends-with) oder explizite vorangestellte Platzhalter verwenden, weisen eine geringere Leistung auf und können in bestimmten Szenarien zu einer schlechten Leistung in der gesamten Organisation führen. Weitere Informationen:

• Leistung mithilfe von FetchXml optimieren
• Die Leistung mit QueryExpression optimieren

Abfragen, die diese Anti-Patterns verwenden, führen zu Leistungsproblemen, da die Abfragen nicht optimiert werden können.

FetchXML

Verwenden Sie keine nachgestellten Platzhalter in Ausdrücken mit like, begins-with, not-begin-with, ends-with oder not-end-with. Hier finden Sie einige Beispiele für nachgestellte Platzhalter:

Schlechte Beispiele
<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

Verwenden Sie keine vorangestellte Platzhalter in Ausdrücken mit Like, BeginsWith, DoesNotBeginWith, EndsWith oder DoesNotEndWith. Hier sind einige Beispiele für die übermäßige Verwendung von Platzhalter:

Schlechte Beispiele
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");

Web-API

Verwenden Sie keine vorangestellten Platzhalter in Ausdrücken mit like, startswith, not startswith, endswith oder not endswith. Hier sind einige Beispiele für die übermäßige Verwendung von Platzhalter:

Schlechte Beispiele
like(name,'%value')
startswith(name,'%value')
not startswith(name,'%value')
endswith(name,'value%')
not endswith(name,'value%')

Siehe auch

Zeilen mithilfe von FetchXml filtern
Zeilen mithilfe von QueryExpression filtern
Abfragen von Daten mithilfe der Web-API

Hinweis

Können Sie uns Ihre Präferenzen für die Dokumentationssprache mitteilen? Nehmen Sie an einer kurzen Umfrage teil. (Beachten Sie, dass diese Umfrage auf Englisch ist.)

Die Umfrage dauert etwa sieben Minuten. Es werden keine personenbezogenen Daten erhoben. (Datenschutzbestimmungen).