使用 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	指定擷取的實體類型。 查詢運算式只能擷取實體類型的集合。 您也可以使用 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. 著作權所有，並保留一切權利。 著作權