다음을 통해 공유

QueryByAttribute 클래스 사용

  • 아티클

 

게시 날짜: 2017년 1월

적용 대상: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Microsoft Dynamics 365(온라인 및 온-프레미스)에서 QueryByAttribute 클래스를 사용하여 값 집합에 대해 특성 집합을 테스트하는 쿼리를 작성할 수 있습니다.RetrieveMultiple 메서드 또는 IOrganizationService.RetrieveMultipleRequest 메서드에 이 클래스를 사용합니다.

다음 표에는 QueryByAttribute 클래스를 사용하여 쿼리 식을 만드는 데 설정할 수 있는 속성이 나와 있습니다.

속성

설명

EntityName

검색할 엔터티 유형을 지정합니다. 쿼리 식은 한 가지 엔터티 유형의 컬렉션만 검색할 수 있습니다.QueryExpression 생성자를 사용하여 이 값을 전달할 수도 있습니다.

ColumnSet

검색할 특성(열)의 집합을 지정합니다.

Attributes

쿼리에서 선택한 특성 집합을 지정합니다.

Values

쿼리가 실행될 때 검색할 특성 값을 지정합니다.

Orders

쿼리에서 반환되는 레코드 순서를 지정합니다.

PageInfo

쿼리에서 반환된 페이지 당 레코드 수 및 페이지 수를 지정합니다.

다음 코드 예제에서는 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"]);    
}

참고 항목

QueryByAttribute
QueryExpression을 사용하여 쿼리 작성
QueryExpression 클래스 사용

Microsoft Dynamics 365

© 2017 Microsoft. All rights reserved. 저작권 정보