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).