QueryByAttribute クラスの使用

[アーティクル]
03/04/2017

公開日: 2017年1月

対象: Dynamics 365 (online)、Dynamics 365 (on-premises)、Dynamics CRM 2016、Dynamics CRM Online

Microsoft Dynamics 365 (オンラインおよび設置型) では、QueryByAttribute クラスを使用して、一群の値に対して一群の属性をテストするクエリを作成できます。このクラスは RetrieveMultiple メソッドまたは IOrganizationService.RetrieveMultipleRequest メソッドで使用します。

QueryByAttribute クラスを使用してクエリ式を作成するために設定できるプロパティを次の表に示します。

プロパティ	説明
EntityName	取得するエンティティの種類を指定します。クエリ式では、1 種類のエンティティのコレクションのみ取得できます。QueryExpression コンストラクターを使用して、この値を渡すこともできます。
ColumnSet	取得する一連の属性 (列) を指定します。
Attributes	クエリ内で選択された一群の属性を指定します。
Values	クエリの実行時に検索する属性値を指定します。
Orders	クエリでレコードを返す順序を指定します。
PageInfo	クエリで返されるページ数、およびページごとのレコード数を指定します。

次のコード例は、QueryByAttribute クラスの使用方法を示しています。

//  Create query using querybyattribute    
QueryByAttribute querybyexpression = new QueryByAttribute("account");    
querybyexpression.ColumnSet = new ColumnSet("name", "address1_city", "emailaddress1");

//  Attribute to query    
querybyexpression.Attributes.AddRange("address1_city");

//  Value of queried attribute to return    
querybyexpression.Values.AddRange("Detroit");    

//  Query passed to the service proxy    
EntityCollection retrieved = _serviceProxy.RetrieveMultiple(querybyexpression);   

//  Iterate through returned collection    
foreach (var c in retrieved.Entities)    
{
      System.Console.WriteLine("Name: " + c.Attributes["name"]);
      System.Console.WriteLine("Address: " + c.Attributes["address1_city"]);      
      System.Console.WriteLine("E-mail: " + c.Attributes["emailaddress1"]);    
}

QueryByAttribute クラスの使用

関連項目

その他のリソース