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

Mehr Informationen: Verwenden Sie die ConditionExpression-Klasse

Web-API

contains
not contains
startswith
not startswith
endswith
not endswith

Weitere Informationen: OData Abragefunktionen 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 Platzhalter am Ende

Die Verwendung von Platzhaltern am Ende wird nicht unterstützt.

FetchXML

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

Schlechte Beispiele
<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 nachgestellten Platzhalter in Ausdrücken, die BeginsWith, DoesNotBeginWith, EndsWith oder DoesNotEndWith verwenden. Hier finden Sie einige Beispiele für nachgestellte Platzhalter:

Schlechte Beispiele
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 nachgestellten Platzhalter in Ausdrücken, die startswith, not startswith, endswith oder not endswith verwenden. Hier finden Sie einige Beispiele für nachgestellte Platzhalter:

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

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

Siehe auch

Daten mithilfe von FetchXml abfragen
Verwenden der ConditionExpression-Klasse
Datenabfrage mit 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).