Utiliser la classe QueryByAttribute

  • Article

 

Date de publication : janvier 2017

S’applique à : Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Dans Microsoft Dynamics 365 (Online et local), vous pouvez utiliser la classe QueryByAttribute pour générer des requêtes qui testent un ensemble d’attributs par rapport à un ensemble de valeurs. Utilisez cette classe avec la méthode RetrieveMultiple ou IOrganizationService.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 classe QueryByAttribute.

Propriété

Description

EntityName

Spécifie le type d’entité qui est récupéré. Une expression de requête peut uniquement récupérer une collection d’un seul type d’entité. Vous pouvez également transmettre cette valeur à l’aide du constructeur QueryExpression.

ColumnSet

Spécifie l’ensemble des attributs (colonnes) à récupérer.

Attributes

Spécifie l’ensemble des attributs sélectionnés dans la requête.

Values

Spécifie les valeurs d’attribut à rechercher lorsque la requête est exécutée.

Orders

Spécifie l’ordre dans lequel l’enregistrement est renvoyé pour la requête.

PageInfo

Spécifie le nombre de pages et le nombre d’enregistrements affichés par page renvoyés pour la requête.

L’exemple de code suivant montre comment utiliser la classe 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"]);    
}

Voir aussi

QueryByAttribute
Générer des requêtes avec QueryExpression
Utiliser la classe QueryExpression

Microsoft Dynamics 365

© 2017 Microsoft. Tous droits réservés. Copyright