ReportItems 컬렉션 참조 사용(보고서 작성기 3.0 및 SSRS)

ReportItems 기본 제공 컬렉션은 데이터 영역의 행 또는 보고서 디자인 화면의 입력란과 같은 보고서 항목의 입력란 집합입니다. ReportItems 컬렉션에는 페이지 머리글, 페이지 바닥글 또는 보고서 본문의 현재 범위에 있는 입력란이 포함됩니다. 이 컬렉션은 보고서 처리기 및 보고서 렌더러에 의해 런타임에 결정됩니다. 현재 범위는 사용자가 보고서 페이지를 볼 때 보고서 처리기가 보고서 데이터 및 보고서 항목 레이아웃 요소를 연속적으로 조합함에 따라 변경됩니다. ReportItems 기본 제공 컬렉션을 사용하여 각 페이지의 첫 번째 및 마지막 항목을 표시하는 사전 스타일의 페이지 머리글을 만들 수 있습니다.

[!참고]

보고서 작성기 3.0 및 Business Intelligence Development Studio의 보고서 디자이너에서 보고서 정의(.rdl)를 만들고 수정할 수 있습니다. 각 제작 환경에서는 보고서 및 관련 항목을 만들고, 열고, 저장할 수 있는 여러 방법을 제공합니다. 자세한 내용은 microsoft.com 웹에서 보고서 디자이너 및 보고서 작성기 3.0에서 보고서 디자인(SSRS)을 참조하십시오.

ReportItems 값 속성 사용

ReportItems 컬렉션 내의 항목에는 Value 속성 하나만 포함됩니다. ReportItems 항목의 값을 사용하면 보고서에 있는 다른 필드의 데이터를 표시하거나 계산할 수 있습니다. 현재 입력란의 값에 액세스하려는 경우 Visual Basic의 기본 제공 전역 Me.Value를 사용하거나 그냥 Value만 사용할 수 있습니다. First와 같은 보고서 함수 및 집계 함수에서는 정규화된 구문을 사용해야 합니다.

예:

  • 이 식을 입력란에 배치하면 Textbox1이라는 ReportItem 입력란의 값이 표시됩니다.

    =ReportItems.Textbox1.Value

  • 이 식을 ReportItem 입력란 Color 속성에 배치하면 값이 > 0인 경우 텍스트가 검정색으로 표시되고 그렇지 않으면 빨간색으로 표시됩니다.

    =IIF(Me.Value > 0,"Black","Red")

  • 이 식을 페이지 머리글 또는 페이지 바닥글의 입력란에 배치하면 LastName이라는 입력란에 대해 렌더링된 보고서의 페이지별 첫 번째 값이 표시됩니다.

    =First(ReportItems("LastName").Value)

사전 스타일의 페이지 머리글 식

페이지의 첫 번째 고객과 마지막 고객을 표시하는 페이지 머리글을 만들 수 있습니다. 페이지 머리글의 입력란은 식에서 ReportItems 기본 제공 컬렉션을 한 번만 참조할 수 있으므로 페이지 머리글에 두 개의 입력란, 즉, 첫 번째 고객 이름에 대한 입력란(=First(ReportItems!textboxLastName.Value)과 마지막 고객 이름에 대한 입력란(=Last(ReportItems!textboxLastName.Value)을 추가해야 합니다.

페이지 머리글 또는 페이지 바닥글 섹션에서는 현재 페이지의 입력란만 ReportItems 컬렉션의 멤버로 사용할 수 있습니다. 예를 들어 ReportItems!textboxLastName.Value가 다중 페이지 데이터 영역에 대한 첫 번째 페이지에만 표시되는 입력란을 참조할 경우 첫 번째 페이지에 대한 값은 볼 수 있지만 다른 모든 페이지에는 식이 작성된 대로 계산될 수 없음을 나타내는 #오류가 표시됩니다.

ReportItems 컬렉션의 범위

보고서가 처리될 때 보고서 본문 또는 데이터 영역의 각 입력란은 해당 데이터 집합, 데이터 영역 및 그룹 연결의 컨텍스트에서 계산됩니다. ReportItems 컬렉션에 대한 참조의 범위는 현재 범위 또는 현재 범위보다 높은 모든 지점입니다.

예를 들어 부모 그룹에 있는 행의 입력란은 자식 그룹 행에 있는 입력란의 이름을 참조하는 식을 포함하면 안 됩니다. 이러한 식은 자식 행 입력란이 범위를 벗어나기 때문에 보고서의 값으로 확인되지 않습니다. 자세한 내용은 집계 함수 참조(보고서 작성기 3.0 및 SSRS)을 참조하십시오.