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