식의 기본 제공 컬렉션(보고서 작성기 및 SSRS)
보고서의 식에 다음 기본 제공 컬렉션에 대한 참조를 포함할 수 있습니다. ReportItems, Parameters, Fields, DataSets, DataSources, Variables, 보고서 이름과 같은 전역 정보에 대한 기본 제공 필드 등의 기본 제공 컬렉션에 대한 참조를 포함할 수 있습니다. 식 대화 상자에 표시되지 않는 컬렉션도 있습니다. DataSets 및 DataSources 컬렉션은 보고서 서버의 게시된 보고서에 대해 런타임에만 사용할 수 있습니다. ReportItems 컬렉션은 페이지 또는 페이지 머리글의 입력란과 같이 보고서 영역에 있는 입력란의 컬렉션입니다.
자세한 내용은 식(보고서 작성기 및 SSRS)을 참조하십시오.
[!참고]
SQL Server Data Tools의 보고서 작성기 및 보고서 디자이너에서 보고서 정의(.rdl)를 만들고 수정할 수 있습니다. 각 제작 환경에서는 보고서 및 관련 항목을 만들고, 열고, 저장할 수 있는 여러 방법을 제공합니다. 자세한 내용은 microsoft.com 웹에서 보고서 디자이너 및 보고서 작성기에서 보고서 디자인(SSRS)을 참조하십시오.
기본 제공 컬렉션 이해
다음 표에서는 식을 작성할 때 사용할 수 있는 기본 제공 컬렉션을 보여 줍니다. 각 행에는 컬렉션에 대한 대/소문자 구분 프로그래밍 이름, 식 대화 상자를 사용하여 컬렉션에 대한 참조를 대화형으로 추가할 수 있는지 여부, 예, 그리고 컬렉션 값이 초기화되어 사용 가능해지는 시점을 포함한 설명이 포함됩니다.
기본 제공 컬렉션 |
식 대화 상자의 범주 |
예 |
설명 |
|---|---|---|---|
Globals |
기본 제공 필드 |
=Globals.ReportName - or - =Globals.PageNumber |
보고서 이름이나 페이지 번호를 비롯하여 보고서에 유용한 전역 변수를 나타냅니다. 항상 사용할 수 있습니다. 자세한 내용은 기본 제공 Globals 및 Users 참조(보고서 작성기 및 SSRS)을 참조하십시오. |
User |
기본 제공 필드 |
=User.UserID -또는- =User.Language |
언어 설정 또는 사용자 ID를 비롯하여 보고서를 실행하는 사용자에 대한 데이터 컬렉션을 나타냅니다. 항상 사용할 수 있습니다. 자세한 내용은 기본 제공 Globals 및 Users 참조(보고서 작성기 및 SSRS)을 참조하십시오. |
Parameters |
매개 변수 |
=Parameters("ReportMonth").Value -또는- =Parameters!ReportYear.Value |
각각 단일 값 또는 다중값일 수 있는 보고서 매개 변수 컬렉션을 나타냅니다. 초기화 처리가 완료된 다음에만 사용할 수 있습니다. 자세한 내용은 매개 변수 컬렉션 참조(보고서 작성기 및 SSRS)을 참조하십시오. |
Fields(<Dataset>) |
필드 |
=Fields!Sales.Value |
보고서에 사용할 수 있는 데이터 집합의 필드 컬렉션을 나타냅니다. 데이터 원본에 있는 데이터를 검색하여 데이터 집합으로 가져온 다음 사용할 수 있습니다. 자세한 내용은 데이터 집합 필드 컬렉션 참조(보고서 작성기 및 SSRS)을 참조하십시오. |
DataSets |
표시되지 않음 |
=DataSets("TopEmployees").CommandText |
보고서 정의 본문에서 참조하는 데이터 집합 컬렉션을 나타냅니다. 페이지 머리글이나 페이지 바닥글에만 사용되는 데이터 원본은 포함되지 않습니다. 로컬 미리 보기에서는 사용할 수 없습니다. 자세한 내용은 DataSources 및 DataSets 컬렉션 참조(보고서 작성기 및 SSRS)을 참조하십시오. |
DataSources |
표시되지 않음 |
=DataSources("AdventureWorks2012").Type |
보고서 본문에서 참조하는 데이터 원본 컬렉션을 나타냅니다. 페이지 머리글이나 페이지 바닥글에만 사용되는 데이터 원본은 포함되지 않습니다. 로컬 미리 보기에서는 사용할 수 없습니다. 자세한 내용은 DataSources 및 DataSets 컬렉션 참조(보고서 작성기 및 SSRS)을 참조하십시오. |
Variables |
Variables |
=Variables!CustomTimeStamp.Value |
보고서 변수 및 그룹 변수의 컬렉션을 나타냅니다. 자세한 내용은 보고서 및 그룹 변수 컬렉션 참조(보고서 작성기 및 SSRS)을 참조하십시오. |
ReportItems |
표시되지 않음 |
=ReportItems("Textbox1").Value |
보고서 항목에 대한 입력란의 컬렉션을 나타냅니다. 이 컬렉션은 페이지 머리글 또는 페이지 바닥글에 포함할 페이지 항목을 요약하는 데 사용할 수 있습니다. 자세한 내용은 ReportItems 컬렉션 참조(보고서 작성기 및 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 |