Partager via


Utiliser la classe QueryByAttribute

Vous pouvez utiliser la QueryByAttribute classe pour générer des requêtes qui testent un ensemble de colonnes (attributs) sur un ensemble de valeurs. Utilisez cette classe avec la RetrieveMultiple méthode ou la IOrganizationServiceméthode .RetrieveMultipleRequest

Le tableau suivant répertorie les propriétés que vous pouvez définir pour créer une expression de requête à l’aide de la QueryByAttribute classe.

Propriété Descriptif
EntityName Spécifie le type de table qui est récupéré. Une expression de requête ne peut récupérer qu’une collection d’un type de table. Vous pouvez également passer cette valeur à l’aide du QueryExpression constructeur.
ColumnSet Spécifie le jeu de colonnes (attributs) à récupérer.
Attributes Spécifie l’ensemble d’attributs sélectionnés dans la requête.
Values Spécifie les valeurs de colonne à rechercher lors de l’exécution de la requête.
Orders Spécifie l’ordre dans lequel les lignes sont renvoyées pour la requête.
PageInfo Spécifie le nombre de pages et le nombre de lignes par page retournées par requête.

L’exemple de code suivant montre comment utiliser la QueryByAttribute classe.

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

Voir aussi

Créer des requêtes avec QueryExpression
QueryByAttribute