QueryExpression クラスの使用
公開日: 2016年11月
対象: Dynamics CRM 2015
Microsoft Dynamics CRM 2015 および Microsoft Dynamics CRM Online では、QueryExpression クラスを使用して、IOrganizationService.RetrieveMultiple メソッドまたは RetrieveMultipleRequest メッセージで使用する複雑なクエリを作成できます。QueryExpression に対するクエリ パラメーターは、ConditionExpression、ColumnSet、および FilterExpression の各クラスを使用して設定できます。
QueryExpression クラスを使用すると、複雑なクエリを作成できます。QueryByAttribute クラスは、指定した値と属性が一致するエンティティを簡単に検索できるように設計されています。
次の表に、クエリ式を作成する際に設定するプロパティを一覧表示します。
プロパティ |
説明 |
---|---|
取得するエンティティの種類を指定します。 クエリ式では、1 種類のエンティティのコレクションのみ取得できます。 |
|
取得する一連の属性 (列) を指定します。 |
|
クエリの結果をフィルターする複雑な条件式および論理フィルター式を指定します。 |
|
クエリの結果に重複するレコードを含めるかどうかを指定します。 |
|
複数のエンティティ種類間のリンクを指定します。 |
|
クエリでレコードを返す順序を指定します。 |
|
クエリで返されるページ数、およびページごとのレコード数を指定します。 |
レコードのカウント
クエリで返るレコードの数を調べるには、クエリを実行する前に ReturnTotalRecordCount プロパティを true に設定します。 これを行うと、TotalRecordCount が設定されます。 それ以外の場合、この値は -1 になります。
例
次のサンプルは、QueryExpression クラスの使用方法を示します。
// Query using ConditionExpression and FilterExpressionConditionExpression condition1 = new ConditionExpression();condition1.AttributeName = "lastname";condition1.Operator = ConditionOperator.Equal;condition1.Values.Add("Brown"); FilterExpression filter1 = new FilterExpression();filter1.Conditions.Add(condition1);QueryExpression query = new QueryExpression("contact");query.ColumnSet.AddColumns("firstname", "lastname");query.Criteria.AddFilter(filter1);EntityCollection result1 = _serviceProxy.RetrieveMultiple(query);Console.WriteLine();Console.WriteLine("Query using Query Expression with ConditionExpression and FilterExpression");Console.WriteLine("---------------------------------------");foreach (var a in result1.Entities){ Console.WriteLine("Name: " + a.Attributes["firstname"] + " " + a.Attributes["lastname"]);}Console.WriteLine("---------------------------------------");
関連項目
QueryExpression
QueryExpression でクエリを作成する
ColumnSet クラスの使用
ConditionExpression クラスの使用
FilterExpression クラスの使用
© 2017 Microsoft. All rights reserved. 著作権