Freigeben über


Verwenden der QueryByAttribute-Klasse

Sie können die QueryByAttribute-Klasse zum Erstellen von Abfragen verwenden, die eine Gruppe von Spalten (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 Tabelle abgerufen wird. Ein Abfrageausdruck kann nur eine Sammlung eines Tabellentyps abrufen. Sie können diesen Wert über den QueryExpression-Konstruktor weitergeben.
ColumnSet Gibt den Satz von Spalten (Attributen) für den Abruf an.
Attributes Gibt den Satz von Attributen an, die in der Abfrage ausgewählt werden.
Values Gibt die Spaltenwerte an, nach denen gesucht wird, wenn die Abfrage ausgeführt wird.
Orders Gibt die Reihenfolge an, in der die Zeilen von der Abfrage zurückgegeben werden.
PageInfo Gibt die Anzahl der Seiten und die Anzahl der Zeilen 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

Erstellen von Abfragen mit QueryExpression
QueryByAttribute

Hinweis

Können Sie uns Ihre Präferenzen für die Dokumentationssprache mitteilen? Nehmen Sie an einer kurzen Umfrage teil. (Beachten Sie, dass diese Umfrage auf Englisch ist.)

Die Umfrage dauert etwa sieben Minuten. Es werden keine personenbezogenen Daten erhoben. (Datenschutzbestimmungen).