Встроенные коллекции в выражениях в отчете с разбивкой на страницы (построитель отчетов)

Применимо к: Microsoft Report Builder (SSRS) Power BI Report Builder конструктор отчетов в SQL Server Data Tools

В выражение в отчете с разбивкой на страницы можно включить ссылки на следующие встроенные коллекции: ReportItems, Parameters, Fields, DataSets, DataSources, Variables и встроенные поля для общих сведений, таких как имя отчета. В диалоговом окне Выражения отображаются не все коллекции. Коллекции DataSets и DataSources доступны только во время выполнения для отчетов, опубликованных на сервере отчетов. Коллекция ReportItems является коллекцией текстовых полей в области отчета, например текстовых полей на странице или в верхнем колонтитуле.

Дополнительные сведения см. в разделе Выражения (построитель отчетов и службы SSRS).

Примечание

Создать и изменить определение для отчета на страницу (RDL-файл) можно с помощью построителя отчетов (Майкрософт), построителя отчетов Power BI и конструктора отчетов в SQL Server Data Tools.

Основные сведения о встроенных коллекциях

В следующей таблице перечислены встроенные коллекции, доступные при написании выражения. Каждая строка включает программное имя коллекции с учетом регистра, признак, можно ли использовать диалоговое окно «Выражение» для интерактивного добавления в коллекцию ссылки, пример и описание, включающее сведения о том, когда инициализируются и становятся доступными для использования значения коллекции.

Встроенная коллекция	Категория в диалоговом окне «Выражение»	Пример	Описание
Глобальные переменные	Встроенные поля	=Globals.ReportName - or - =Globals.PageNumber	Представляет глобальные переменные, полезные для отчетов, например для имени отчета или номера страницы. Доступна всегда. Дополнительные сведения см. в разделе Встроенные глобальные значения и ссылки на пользовательские поля (построитель отчетов и службы SSRS).
Пользователь	Встроенные поля	=User.UserID — или — =User.Language	Представляет коллекцию сведений о пользователе, выполняющем отчет, например языковые настройки или идентификатор пользователя. Доступна всегда. Дополнительные сведения см. в разделе Встроенные глобальные значения и ссылки на пользовательские поля (построитель отчетов и службы SSRS).
Параметры	Параметры	=Parameters("ReportMonth").Value — или — =Parameters!ReportYear.Value	Представляет коллекцию параметров отчета, каждый из которых может быть однозначным или многозначным. Недоступна до завершения обработки инициализации. Дополнительные сведения см. в разделе Ссылки на коллекцию параметров (построитель отчетов и службы SSRS).
Fields(<набор_данных>>)	Поля	=Fields!Sales.Value	Представляет коллекцию полей набора данных, доступных для отчета. Доступна после получения данных из источника данных в набор данных. Дополнительные сведения см. в разделе Ссылки на коллекцию полей набора данных (построитель отчетов и службы SSRS).
Наборы данных	Не отображается	=DataSets("TopEmployees").CommandText	Представляет коллекцию наборов данных, к которым выполняется обращение из тела определения отчета. Не включает источники данных, которые используются только в верхних или нижних колонтитулах. Недоступна в режиме локального предварительного просмотра. Дополнительные сведения см. в разделе Ссылки на коллекции DataSources и DataSets (построитель отчетов и службы SSRS).
Коллекция DataSources	Не отображается	=DataSources("AdventureWorks2022").Type	Представляет коллекцию источников данных, к которым выполняется обращение из тела отчета. Не включает источники данных, которые используются только в верхних или нижних колонтитулах. Недоступна в режиме локального предварительного просмотра. Дополнительные сведения см. в разделе Ссылки на коллекции DataSources и DataSets (построитель отчетов и службы SSRS).
Переменные	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

См. также:

Добавление выражения (построитель отчетов и службы SSRS)
Примеры выражений (построитель отчетов и службы SSRS)