次の方法で共有


QueryByAttribute クラスの使用

 

公開日: 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
QueryExpression でクエリを作成する
QueryExpression クラスの使用

Microsoft Dynamics 365

© 2017 Microsoft. All rights reserved. 著作権