식에 기본 제공 컬렉션 사용(보고서 작성기 3.0 및 SSRS)
보고서의 식에 다음 기본 제공 컬렉션에 대한 참조를 포함할 수 있습니다. ReportItems, Parameters, Fields, DataSets, DataSources, Variables, 보고서 이름과 같은 전역 정보에 대한 기본 제공 필드 등의 기본 제공 컬렉션에 대한 참조를 포함할 수 있습니다. 식 대화 상자에 표시되지 않는 컬렉션도 있습니다. DataSets 및 DataSources 컬렉션은 보고서 서버의 게시된 보고서에 대해 런타임에만 사용할 수 있습니다. ReportItems 컬렉션은 페이지 또는 페이지 머리글의 입력란과 같이 보고서 영역에 있는 입력란의 컬렉션입니다.
자세한 내용은 식(보고서 작성기 3.0 및 SSRS)을 참조하십시오.
[!참고]
보고서 작성기 3.0 및 Business Intelligence Development Studio의 보고서 디자이너에서 보고서 정의(.rdl)를 만들고 수정할 수 있습니다. 각 제작 환경에서는 보고서 및 관련 항목을 만들고, 열고, 저장할 수 있는 여러 방법을 제공합니다. 자세한 내용은 microsoft.com 웹에서 보고서 디자이너 및 보고서 작성기 3.0에서 보고서 디자인(SSRS)을 참조하십시오.
기본 제공 컬렉션 이해
다음 표에서는 식을 쓸 때 사용할 수 있는 기본 제공 컬렉션을 보여 줍니다. 각 행에는 컬렉션에 대한 대/소문자 구분 프로그래밍 이름, 식 대화 상자를 사용하여 컬렉션에 대한 참조를 대화형으로 추가할 수 있는지 여부, 예, 그리고 컬렉션 값이 초기화되어 사용 가능해지는 시점을 포함한 설명이 포함됩니다.
기본 제공 컬렉션 |
식 대화 상자의 범주 |
예 |
설명 |
|---|---|---|---|
Globals |
기본 제공 필드 |
=Globals.ReportName - or - =Globals.PageNumber |
보고서 이름이나 페이지 번호를 비롯하여 보고서에 유용한 전역 변수를 나타냅니다. 항상 사용할 수 있습니다. 자세한 내용은 기본 제공 Globals 및 Users 필드 참조 사용(보고서 작성기 3.0 및 SSRS)을 참조하십시오. |
User |
기본 제공 필드 |
=User.UserID -또는- =User.Language |
언어 설정 또는 사용자 ID를 비롯하여 보고서를 실행하는 사용자에 대한 데이터 컬렉션을 나타냅니다. 항상 사용할 수 있습니다. 자세한 내용은 기본 제공 Globals 및 Users 필드 참조 사용(보고서 작성기 3.0 및 SSRS)을 참조하십시오. |
Parameters |
매개 변수 |
=Parameters("ReportMonth").Value -또는- =Parameters!ReportYear.Value |
각각 단일 값 또는 다중값일 수 있는 보고서 매개 변수 컬렉션을 나타냅니다. 초기화 처리가 완료된 다음에만 사용할 수 있습니다. 자세한 내용은 매개 변수 컬렉션 참조 사용(보고서 작성기 3.0 및 SSRS)을 참조하십시오. |
Fields(<Dataset>) |
필드 |
=Fields!Sales.Value |
보고서에 사용할 수 있는 데이터 집합의 필드 컬렉션을 나타냅니다. 데이터 원본에 있는 데이터를 검색하여 데이터 집합으로 가져온 다음 사용할 수 있습니다. 자세한 내용은 데이터 집합 필드 컬렉션 참조 사용(보고서 작성기 3.0 및 SSRS)을 참조하십시오. |
DataSets |
표시되지 않음 |
=DataSets("TopEmployees").CommandText |
보고서 정의 본문에서 참조하는 데이터 집합 컬렉션을 나타냅니다. 페이지 머리글이나 페이지 바닥글에만 사용되는 데이터 원본은 포함되지 않습니다. 로컬 미리 보기에서는 사용할 수 없습니다. 자세한 내용은 DataSources 및 DataSets 컬렉션 참조 사용(보고서 작성기 3.0 및 SSRS)을 참조하십시오. |
DataSources |
표시되지 않음 |
=DataSources("AdventureWorks").Type |
보고서 본문에서 참조하는 데이터 원본 컬렉션을 나타냅니다. 페이지 머리글이나 페이지 바닥글에만 사용되는 데이터 원본은 포함되지 않습니다. 로컬 미리 보기에서는 사용할 수 없습니다. 자세한 내용은 DataSources 및 DataSets 컬렉션 참조 사용(보고서 작성기 3.0 및 SSRS)을 참조하십시오. |
Variables |
Variables |
=Variables!CustomTimeStamp.Value |
보고서 변수 및 그룹 변수의 컬렉션을 나타냅니다. 자세한 내용은 보고서 및 그룹 변수 컬렉션 참조 사용(보고서 작성기 3.0 및 SSRS)을 참조하십시오. |
ReportItems |
표시되지 않음 |
=ReportItems("Textbox1").Value |
보고서 항목에 대한 입력란의 컬렉션을 나타냅니다. 이 컬렉션은 페이지 머리글 또는 페이지 바닥글에 포함할 페이지 항목을 요약하는 데 사용할 수 있습니다. 자세한 내용은 ReportItems 컬렉션 참조 사용(보고서 작성기 3.0 및 SSRS)을 참조하십시오. |
식에서 컬렉션 구문 사용
식에서 컬렉션을 참조하려면 컬렉션의 항목에 대한 표준 Microsoft Visual Basic 구문을 사용합니다. 다음 표에서는 컬렉션 구문의 예를 보여 줍니다.
구문 |
예 |
|---|---|
Collection!ObjectName.Property |
=Fields!Sales.Value |
Collection!ObjectName("Property") |
=Fields!Sales("Value") |
Collection("ObjectName").Property |
=Fields("Sales").Value |
Collection("Member") |
=User("Language") |
Collection.Member |
=User.Language |
사용자 지정 어셈블리에 기본 제공 컬렉션 전달
기본 제공 컬렉션을 처리하기 위해 사용자 지정 어셈블리로 전달하려는 경우 해당 기본 제공 컬렉션을 정의하는 어셈블리에 코드 프로젝트의 어셈블리 참조를 추가하고 올바른 네임스페이스에 액세스해야 합니다. 보고서 서버에서 실행되는 보고서(서버 보고서)에 대한 사용자 지정 어셈블리를 개발할지 또는 .NET 응용 프로그램에서 로컬로 실행되는 보고서에 대한 사용자 지정 어셈블리를 개발할지에 따라 참조해야 하는 어셈블리가 다릅니다. 자세한 내용은 다음을 참조하십시오.
네임스페이스: Microsoft.ReportingServices.ReportProcessing.ReportObjectModel
어셈블리(로컬 보고서): Microsoft.ReportingServices.ProcessingObjectModel.dll
어셈블리(서버 보고서): Microsoft.ReportViewer.ProcessingObjectModel.dll
Fields 및 ReportItems 컬렉션의 내용은 런타임에 동적으로 변경될 수 있으므로 호출에서 이러한 내용을 사용자 지정 어셈블리(예: 멤버 변수)에 유지해서는 안 됩니다. 이 권장 사항은 일반적으로 모든 기본 제공 컬렉션에 적용됩니다.