Compartilhar via


Usar a classe de QueryByAttribute

 

Publicado: janeiro de 2017

Aplicável a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Em Microsoft Dynamics 365 (online e local), você pode usar a classe QueryByAttribute para criar consultas que testam um conjunto de atributos em um conjunto de valores. Use esta classe com o método de RetrieveMultiple ou o método IOrganizationService.RetrieveMultipleRequest.

A tabela a seguir lista as propriedades que podem ser definidas para criar uma expressão de consulta usando a classe QueryByAttribute.

Propriedade

Descrição

EntityName

Especifica qual tipo de entidade for recuperado. Uma expressão de consulta só pode recuperar uma coleção de um tipo de entidade. Você também pode passar esse valor usando o construtor QueryExpression.

ColumnSet

Especifica o conjunto de atributos (colunas) para recuperação.

Attributes

Especifica o conjunto de atributos selecionados na consulta.

Values

Especifica os valores de atributo para procurar quando a consulta é executada.

Orders

Especifica a ordem em que os registros são retornados da consulta.

PageInfo

Especifica o número de páginas e o número de registros por página retornados da consulta.

O exemplo de código a seguir mostra como usar a 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"]);    
}

Confira Também

QueryByAttribute
Criar consultas com QueryExpression
Use a classe QueryExpression

Microsoft Dynamics 365

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais