식에 기본 제공 컬렉션(보고서 작성기 및 SSRS)Built-in Collections in Expressions (Report Builder)

보고서의 식에는 ReportItems, 매개 변수, 필드, 데이터 집합, 데이터 원본, 변수 및 보고서 이름과 같은 전역 정보에 대한 기본 제공 필드 등 기본 제공 컬렉션에 대한 참조가 포함될 수 있습니다.In an expression in a report, you can include references to the following built-in collections: ReportItems, Parameters, Fields, DataSets, DataSources, Variables, and built-in fields for global information such as the report name. 대화 상자에 표시되지 않는 컬렉션도 있습니다.Not all collections appear in the Expression dialog box. DataSets 및 DataSources 컬렉션은 보고서 서버의 게시된 보고서에 대해 런타임에만 사용할 수 있습니다.The DataSets and DataSources collections are available only at run-time for published reports on a report server. ReportItems 컬렉션은 페이지 또는 페이지 머리글의 입력란과 같이 보고서 영역에 있는 입력란의 컬렉션입니다.The ReportItems collection is collection of text boxes in a report region, for example, the text boxes on a page or in a page header.

자세한 내용은 식(보고서 작성기 및 SSRS)을 참조하세요.For more information, see Expressions (Report Builder and SSRS).

참고

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.

기본 제공 컬렉션 이해Understanding Built-in Collections

다음 표에서는 식을 작성할 때 사용할 수 있는 기본 제공 컬렉션을 보여 줍니다.The following table lists the built-in collections available when you write an expression. 각 행에는 컬렉션에 대한 대/소문자 구분 프로그래밍 이름, 식 대화 상자를 사용하여 컬렉션에 대한 참조를 대화형으로 추가할 수 있는지 여부, 예, 그리고 컬렉션 값이 초기화되어 사용 가능해지는 시점을 포함한 설명이 포함됩니다.Each row includes the case-sensitive programmatic name for the collection, whether you can use the Expression dialog box to interactively add a reference to the collection, an example, and a description that includes when the collection values are initialized and available for use.

기본 제공 컬렉션Built-in Collection 식 대화 상자의 범주Category in the Expression dialog box 예제Example DescriptionDescription
GlobalsGlobals 기본 제공 필드Built-in Fields =Globals.ReportName

- or -

=Globals.PageNumber
보고서 이름이나 페이지 번호를 비롯하여 보고서에 유용한 전역 변수를 나타냅니다.Represents global variables useful for reports, such as the report name or page number. 항상 사용할 수 있습니다.Always available.

자세한 내용은 기본 제공 Globals 및 Users 참조(보고서 작성기 및 SSRS)를 참조하세요.For more information, see Built-in Globals and Users References (Report Builder and SSRS).
사용자User 기본 제공 필드Built-in Fields =User.UserID

-또는-- or -

=User.Language
언어 설정 또는 사용자 ID를 비롯하여 보고서를 실행하는 사용자에 대한 데이터 컬렉션을 나타냅니다.Represents a collection of data about the user running the report, such as the language setting or the user ID. 항상 사용할 수 있습니다.Always available.

자세한 내용은 기본 제공 Globals 및 Users 참조(보고서 작성기 및 SSRS)를 참조하세요.For more information, see Built-in Globals and Users References (Report Builder and SSRS).
매개 변수Parameters 매개 변수Parameters =Parameters("ReportMonth").Value

-또는-- or -

=Parameters!ReportYear.Value
각각 단일 값 또는 다중값일 수 있는 보고서 매개 변수 컬렉션을 나타냅니다.Represents the collection of report parameters, each of which can be single-value or multivalue. 초기화 처리가 완료된 다음에만 사용할 수 있습니다.Not available until processing initialization is complete. 자세한 내용은 매개 변수 컬렉션 참조(보고서 작성기 및 SSRS)를 참조하세요.For more information, see Parameters Collection References (Report Builder and SSRS).
필드( <Dataset> )Fields( <Dataset> ) 필드Fields =Fields!Sales.Value 보고서에 사용할 수 있는 데이터 집합의 필드 컬렉션을 나타냅니다.Represents the collection of fields of the dataset that are available to the report. 데이터 원본에 있는 데이터를 검색하여 데이터 집합으로 가져온 다음 사용할 수 있습니다.Available after data is retrieved from a data source into a dataset. 자세한 내용은 데이터 집합 필드 컬렉션 참조(보고서 작성기 및 SSRS)를 참조하세요.For more information, see Dataset Fields Collection References (Report Builder and SSRS).
DataSetsDataSets 표시되지 않음Not Displayed =DataSets("TopEmployees").CommandText 보고서 정의 본문에서 참조하는 데이터 집합 컬렉션을 나타냅니다.Represents the collection of datasets referenced from the body of a report definition. 페이지 머리글이나 페이지 바닥글에만 사용되는 데이터 원본은 포함되지 않습니다.Does not include data sources used only in page headers or page footers. 로컬 미리 보기에서는 사용할 수 없습니다.Not available in local preview. 자세한 내용은 DataSources 및 DataSets 컬렉션 참조(보고서 작성기 및 SSRS)를 참조하세요.For more information, see DataSources and DataSets Collection References (Report Builder and SSRS).
DataSourcesDataSources 표시되지 않음Not Displayed =DataSources("AdventureWorks2012").Type 보고서 본문에서 참조하는 데이터 원본 컬렉션을 나타냅니다.Represents the collection of data sources referenced from within the body of a report. 페이지 머리글이나 페이지 바닥글에만 사용되는 데이터 원본은 포함되지 않습니다.Does not include data sources used only in page headers or page footers. 로컬 미리 보기에서는 사용할 수 없습니다.Not available in local preview. 자세한 내용은 DataSources 및 DataSets 컬렉션 참조(보고서 작성기 및 SSRS)를 참조하세요.For more information, see DataSources and DataSets Collection References (Report Builder and SSRS).
변수Variables Variables =Variables!CustomTimeStamp.Value 보고서 변수 및 그룹 변수의 컬렉션을 나타냅니다.Represents the collection of report variables and group variables. 자세한 내용은 보고서 및 그룹 변수 컬렉션 참조(보고서 작성기 및 SSRS)를 참조하세요.For more information, see Report and Group Variables Collections References (Report Builder and SSRS).
ReportItemsReportItems 표시되지 않음Not Displayed =ReportItems("Textbox1").Value 보고서 항목에 대한 입력란의 컬렉션을 나타냅니다.Represents the collection of text boxes for a report item. 이 컬렉션은 페이지 머리글 또는 페이지 바닥글에 포함할 페이지 항목을 요약하는 데 사용할 수 있습니다.This collection can be used to summarize items on the page for including in a page header or page footer. 자세한 내용은 ReportItems 컬렉션 참조(보고서 작성기 및 SSRS)를 참조하세요.For more information, see ReportItems Collection References (Report Builder and SSRS).

식에서 컬렉션 구문 사용Using Collection Syntax in an Expression

식에서 컬렉션을 참조하려면 컬렉션의 항목에 대한 표준 MicrosoftMicrosoft Visual BasicVisual Basic 구문을 사용합니다.To refer to a collection from an expression, use standard MicrosoftMicrosoft Visual BasicVisual Basic syntax for an item in a collection. 다음 표에서는 컬렉션 구문의 예를 보여 줍니다.The following table shows examples of collection syntax.

구문Syntax 예제Example
Collection!ObjectName.PropertyCollection!ObjectName.Property =Fields!Sales.Value
Collection!ObjectName("Property")Collection!ObjectName("Property") =Fields!Sales("Value")
Collection("ObjectName").PropertyCollection("ObjectName").Property =Fields("Sales").Value
Collection("Member")Collection("Member") =User("Language")
Collection.MemberCollection.Member =User.Language

관련 항목:See Also

식 추가(보고서 작성기 및 SSRS) Add an Expression (Report Builder and SSRS)
식 예(보고서 작성기 및 SSRS)Expression Examples (Report Builder and SSRS)