文字列値の条件でワイルドカード文字を使用する

次の演算子を持つ文字列値の条件を使用してクエリを作成する場合は、ワイルドカード文字を使用できます。

FetchXml

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

詳細: FetchXML の使用によるクエリの作成

QueryExpression

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

詳細: ConditionExpression クラスを使用する

Web API

contains
not contains
startswith
not startswith
endswith
notendswith

詳細: 標準クエリ機能

これらの条件演算子を使用する場合、検索条件でワイルドカードを表すために特定の文字を使用できます。

これらの文字について、次のテーブルで説明します。

文字	説明	T-SQL のドキュメントと例
%	0 文字以上の任意の文字列に一致します。 このワイルドカード文字は、接頭辞または接尾辞として使用できます。	パーセント記号 (ワイルドカード - 一致する文字) (Transact-SQL)
_	アンダースコア文字を使用して、パターン マッチングを含む文字列比較操作で任意の 1 文字を照合します。	_ (ワイルドカード - 1 つの文字に一致) (Transact-SQL)
[]	かっこで囲まれた指定範囲またはセット内の任意の 1 文字に一致します。	[ ] (ワイルドカード - 一致する文字) (Transact-SQL)
[^]	角かっこで囲まれた指定範囲またはセット内にはない任意の 1 文字に一致します。	[^] (ワイルドカード - 一致しない文字) (Transact-SQL)

ワイルドカード文字を含む文字列を検索する

ワイルドカード パターン マッチング文字をリテラル文字として使用できます。 ワイルドカード文字をリテラル文字として使用するには、ワイルドカード文字をかっこで囲みます。 詳細: リテラルとしてのワイルドカード文字の使用。

末尾のワイルドカードは使用しないでください

末尾のワイルドカードの使用はサポートされていません。

FetchXml

重要

begins-with、not-begin-with、ends-with、not-end-with を使用する式で末尾のワイルドカードを使用しないでください。 次のテーブルに、末尾のワイルドカードの例をいくつか示します。

悪い例
<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

重要

BeginsWith、DoesNotBeginWith、EndsWith、DoesNotEndWith を使用する式で末尾のワイルドカードを使用しないでください。 次のテーブルに、末尾のワイルドカードの例をいくつか示します。

悪い例
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

重要

startswith、not startswith、endswith、not endswith を使用する式で末尾のワイルドカードを使用しないでください。 次のテーブルに、末尾のワイルドカードの例をいくつか示します。

悪い例
startswith(name,'%value')
not startswith(name,'%value')
endswith(name,'value%')
not endswith(name,'value%')

これらのアンチ パターンを使用するクエリでは、クエリを最適化できないため、パフォーマンスの問題が発生します。

関連情報

FetchXML の使用によるクエリの作成
ConditionExpression クラスの使用
Web API を使用したデータのクエリ

注意

ドキュメントの言語設定についてお聞かせください。 簡単な調査を行います。 (この調査は英語です)

この調査には約 7 分かかります。 個人データは収集されません (プライバシー ステートメント)。