기본 제공 컬렉션-ReportItems 컬렉션 참조 (보고서 작성기)Built-in Collections - ReportItems Collection References (Report Builder)

ReportItems 기본 제공 컬렉션은 데이터 영역의 행 또는 보고서 디자인 화면의 입력란과 같은 보고서 항목의 입력란 집합입니다.The ReportItems built-in collection is the set of text boxes from report items such as rows of a data region or text boxes on the report design surface. ReportItems 컬렉션에는 페이지 머리글, 페이지 바닥글 또는 보고서 본문의 현재 범위에 있는 입력란이 포함됩니다.The ReportItems collection includes text boxes that are in the current scope of a page header, page footer, or report body. 이 컬렉션은 보고서 처리기 및 보고서 렌더러에 의해 런타임에 결정됩니다.This collection is determined at run time by the report processor and the report renderer. 현재 범위는 사용자가 보고서 페이지를 볼 때 보고서 처리기가 보고서 데이터 및 보고서 항목 레이아웃 요소를 연속적으로 조합함에 따라 변경됩니다.The current scope changes as the report processor successively combines report data and the report item layout elements as the user views pages of a report. ReportItems 기본 제공 컬렉션을 사용하여 각 페이지의 첫 번째 및 마지막 항목을 표시하는 사전 스타일의 페이지 머리글을 만들 수 있습니다.You can use the ReportItems built-in collection to produce dictionary-style page headers that show the first and last items on each page.

참고

SQL Server Data Tools의 보고서 작성기 및 보고서 디자이너에서 페이지를 매긴 보고서 정의(.rdl) 파일을 만들고 수정할 수 있습니다.You can create and modify paginated report definition (.rdl) files in Report Builder and in Report Designer in SQL Server Data Tools. 각 제작 환경에서는 보고서 및 관련 항목을 만들고, 열고, 저장할 수 있는 여러 방법을 제공합니다.Each authoring environment provides different ways to create, open, and save reports and related items.

ReportItems 값 속성 사용Using the ReportItems Value Property

ReportItems 컬렉션 내의 항목에는 Value라는 하나의 속성만 있습니다.Items within the ReportItems collection have only one property: Value. ReportItems 항목의 값을 사용하면 보고서에 있는 다른 필드의 데이터를 표시하거나 계산할 수 있습니다.The value for a ReportItems item can be used to display or calculate data from another field in the report. 현재 입력란의 값에 액세스하려는 경우 Visual BasicVisual Basic 기본 제공 전역 Me.Value를 사용하거나 그냥 Value만 사용할 수 있습니다.To access the value of the current text box, you can use the Visual BasicVisual Basic built-in global Me.Value or simply Value. First와 같은 보고서 함수 및 집계 함수에서는 정규화된 구문을 사용해야 합니다.In report functions such as First and aggregate functions, use the fully qualified syntax.

예를 들어For example:

  • 이 식을 입력란에 배치하면 이라는 ReportItem Textbox1입력란의 값이 표시됩니다.This expression, placed in a text box, displays the value of a ReportItem text box named Textbox1:

    =ReportItems!Textbox1.Value

  • 에 배치 된이 식은 한 ReportItem 텍스트 상자 색 속성 값이 > 0 검은색으로 텍스트를 표시, 그렇지 않으면, 값 빨간색으로 표시 됩니다.This expression, placed in a ReportItem text box Color property, displays the text in black when the value is > 0; otherwise, the value is displayed in red:

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

  • 이 식을 페이지 머리글 또는 페이지 바닥글의 입력란에 배치하면 LastName이라는 입력란에 대해 렌더링된 보고서의 페이지별 첫 번째 값이 표시됩니다.This expression, placed in a text box in the page header or page footer, displays the first value per page of the rendered report, for a text box named LastName:

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

사전 스타일의 페이지 머리글 식Dictionary-Style Page Header Expressions

페이지의 첫 번째 고객과 마지막 고객을 표시하는 페이지 머리글을 만들 수 있습니다.You can create a page header to display the first customer on the page and the last customer on the page. 페이지 머리글의 입력란은 식에서 ReportItems 기본 제공 컬렉션을 한 번만 참조할 수 있으므로 페이지 머리글에 두 개의 입력란을 추가해야 합니다. 하나는 첫 번째 고객 이름에 대한 입력란(=First(ReportItems!textboxLastName.Value)이고 다른 하나는 마지막 고객 이름에 대한 입력란(=Last(ReportItems!textboxLastName.Value)입니다.Because a text box in the page header can only refer to the ReportItems built-in collection once in an expression, you need to add two text boxes to the page header: one for the first customer name (=First(ReportItems!textboxLastName.Value) and one for the last customer name (=Last(ReportItems!textboxLastName.Value).

페이지 머리글 또는 페이지 바닥글 섹션에서는 현재 페이지의 입력란만 ReportItems 컬렉션의 멤버로 사용할 수 있습니다.In a page header or page footer section, only text boxes on the current page are available as a member of the ReportItems collection. 예를 들어 ReportItems!textboxLastName.Value 가 다중 페이지 데이터 영역에 대한 첫 번째 페이지에만 표시되는 입력란을 참조할 경우 첫 번째 페이지에 대한 값은 볼 수 있지만 다른 모든 페이지에는 식이 작성된 대로 계산될 수 없음을 나타내는 #오류 가 표시됩니다.For example, if ReportItems!textboxLastName.Value refers to a text box that only appears on the first page for a multipage data region, you see a value for the first page, but all other pages display #Error to show the expression could not be evaluated as written.

ReportItems 컬렉션의 범위Scope for the ReportItems Collection

보고서가 처리될 때 보고서 본문 또는 데이터 영역의 각 입력란은 해당 데이터 집합, 데이터 영역 및 그룹 연결의 컨텍스트에서 계산됩니다.As the report is processed, each text box in the report body or in a data region is evaluated in the context of its dataset, data region, and group associations. ReportItems 컬렉션에 대한 참조의 범위는 현재 범위 또는 현재 범위보다 높은 모든 지점입니다.The scope for a reference to the ReportItems collection is the current scope or any point higher than the current scope.

예를 들어 부모 그룹에 있는 행의 입력란은 자식 그룹 행에 있는 입력란의 이름을 참조하는 식을 포함하면 안 됩니다.For example, a text box in a row that is in a parent group must not contain an expression that refers to the name of a text box in a child group row. 이러한 식은 자식 행 입력란이 범위를 벗어나기 때문에 보고서의 값으로 확인되지 않습니다.Such an expression does not resolve to a value in the report because the child row text box is out of scope. 자세한 내용은 집계 함수 참조(보고서 작성기 및 SSRS)를 참조하세요.For more information, see Aggregate Functions Reference (Report Builder and SSRS).

관련 항목:See Also

식 (의 기본 제공 컬렉션 보고서 작성기 및 SSRS ) Built-in Collections in Expressions (Report Builder and SSRS)
식 예 ( 보고서 작성기 및 SSRS ) Expression Examples (Report Builder and SSRS)
Reporting services(의 페이지 매김 보고서 작성기 및 SSRS ) Pagination in Reporting Services (Report Builder and SSRS)
필터, 그룹 및 데이터 정렬 ( 보고서 작성기 및 SSRS )Filter, Group, and Sort Data (Report Builder and SSRS)