QueryExpression クラスの使用

Microsoft Dataverse では、QueryExpression クラスを使用して、IOrganizationService.RetrieveMultiple メソッドまたは RetrieveMultipleRequest メッセージによってクエリの結果セットを絞り込むことができます。 QueryExpression に対するクエリ パラメーターは、ConditionExpression、ColumnSet、および FilterExpression の各クラスを使用して設定できます。

QueryExpression クラスを使用すると、複雑なクエリを作成できます。 QueryByAttribute クラスは、指定した値と列が一致するテーブル行を簡単に検索できるよう設計されています。

レコードのカウント

クエリで返るレコードの数を調べるには、クエリを実行する前に ReturnTotalRecordCount プロパティを true に設定します。 これを行うと、TotalRecordCount が設定されます。 そうでない場合、この値は -1 です。

例

次のサンプルは、QueryExpression クラスの使用方法を示します。

//  Query using ConditionExpression and FilterExpression  
ConditionExpression 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("---------------------------------------");  

クエリ内の SQL ヒントを使用

QueryExpression クラスでは QueryHints という名前のプロパティが含まれています。 このプロパティを以下に示すサポートされている文字列値のいずれかに設定することにより、クエリの実行に影響する生成された SQL テキストのヒントを提供できます。

詳細: ヒント (Transact-SQL) - クエリ

関連項目

QueryExpression でクエリを作成する
ColumnSet クラスの使用
ConditionExpression クラスの使用
FilterExpression クラスの使用
QueryExpression