Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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"]);
}