Verwenden der QueryByAttribute-Klasse

  • Artikel

 

Veröffentlicht: Januar 2017

Gilt für: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

In Microsoft Dynamics 365 (online und lokal) können Sie die QueryByAttribute-Klasse zum Erstellen von Abfragen verwenden, die eine Gruppe von Attributen hinsichtlich einer Gruppe von Werten testen. Verwenden Sie diese Klasse mit der RetrieveMultiple-Methode oder der IOrganizationService.RetrieveMultipleRequest-Methode.

In der folgenden Tabelle sind die Eigenschaften aufgelistet, die Sie festlegen können, um einen Abfrageausdruck mithilfe der QueryByAttribute-Klasse zu erstellen.

Eigenschaft

Beschreibung

EntityName

Gibt an, welcher Typ der Entität abgerufen wird. Ein Abfrageausdruck kann nur eine Sammlung eines Entitätstyps abrufen. Sie können diesen Wert über den QueryExpression-Konstruktor weitergeben.

ColumnSet

Gibt den Satz von Attributen (Spalten) für den Abruf an.

Attributes

Gibt den Satz von Attributen an, die in der Abfrage ausgewählt werden.

Values

Gibt die Attributwerte an, nach denen gesucht wird, wenn die Abfrage ausgeführt wird.

Orders

Gibt die Reihenfolge an, in der die Datensätze von der Abfrage zurückgegeben werden.

PageInfo

Gibt die Anzahl von Seiten und die Anzahl der Datensätze pro Seite an, die von der Abfrage zurückgegeben werden.

Im folgenden Code wird gezeigt, wie die QueryByAttribute-Klasse verwendet wird.

//  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"]);    
}

Siehe auch

QueryByAttribute
Erstellen von Abfragen mit QueryExpression
Verwenden der QueryExpression-Klasse

Microsoft Dynamics 365

© 2017 Microsoft. Alle Rechte vorbehalten. Copyright