Ссылки на коллекции параметров в отчете с разбивкой на страницы (построитель отчетов)

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

Параметры отчета с разбивкой на страницы являются одной из встроенных коллекций, на которые можно ссылаться из выражения. Включая в выражение параметры, можно настраивать внешний вид и данные отчета в соответствии с выбором пользователя. Выражения можно использовать для любого свойства элемента отчета или свойства текстового поля, предоставляющего параметр (*Fx).<Expression> Кроме того, выражения применяются для дополнительного управления содержимым отчета и его внешним видом. Дополнительные сведения см. в примерах выражений (построитель отчетов).

При сравнении значений параметров со значениями полей набора данных во время выполнения типы данных для двух сравниваемых элементов должны совпадать. Параметры отчета могут относиться к одному из следующих типов: Boolean, DateTime, Integer, Float или Text, представляющий базовый тип данных String. При необходимости может понадобиться преобразовать тип данных параметра, чтобы он соответствовал значению набора данных. Дополнительные сведения см. в разделе "Типы данных" в выражениях (построитель отчетов).

Чтобы включить ссылку на параметр в выражении, необходимо понять, как указать правильный синтаксис для ссылки на параметр. Синтаксис зависит от того, является ли параметр одним значением или параметром с несколькими значениями.

Примечание.

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

Использование однозначного параметра в выражении

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

Пример	Description
=Parameters! <ParameterName> .IsMultiValue	Возвращает значение False. Проверяет, является ли параметр многозначным. Если значение True, параметр имеет многозначное значение и представляет собой коллекцию объектов. Если возвращено значение False, значит, параметр является однозначным и представляет собой один объект.
=Parameters! <ParameterName> .Count	Возвращает целочисленное значение 1. Для однозначного параметра счетчик всегда равен 1.
=Parameters! <ParameterName> .Label	Возвращает метку параметра, часто используемую в качестве отображаемого имени в списке доступных значений.
=Parameters! <ParameterName> .Value	Возвращает значение параметра. Если свойство Label не задано, это значение отображается в списке доступных значений.
=CStr(Parameters! <ParameterName> .Value)	Возвращает значение параметра в виде строки.
=Fields(Parameters! <ParameterName> .Value).Value	Возвращает значение поля с таким же именем, как и у параметра.

Дополнительные сведения об использовании параметров в фильтре см. в разделе "Добавление фильтров наборов данных", фильтров регионов данных и фильтров групп (построитель отчетов).

Использование многозначного параметра в выражении

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

Пример	Description
=Parameters! <MultivalueParameterName> .IsMultiValue	Возвращает значение True или False. Проверяет, является ли параметр многозначным. Если возвращено значение True, то параметр является многозначным и представляет собой коллекцию объектов. Если возвращено значение False, значит, параметр является однозначным и представляет собой один объект.
=Parameters! <MultivalueParameterName> .Count	Возвращает целочисленное значение. Относится к количеству значений. Для однозначного параметра счетчик всегда равен 1. Для многозначного параметра счетчик имеет значение 0 или больше.
=Parameters! <MultivalueParameterName> .Value(0)	Возвращает первое значение многозначного параметра.
=Parameters! <MultivalueParameterName> .Value(Parameters! <MultivalueParameterName> .Count-1)	Возвращает последнее значение многозначного параметра.
=Split("Value1,Value2,Value3",",")	Возвращает массив значений. Создает массив значений для многозначного параметра типа String . Во втором параметре можно использовать любой разделитель для разбиения. Это выражение можно использовать для задания значений по умолчанию для многозначного параметра или для создания такого многозначного параметра, который надо отослать во вложенный или детализированный отчет.
=Join(Parameters! <MultivalueParameterName> .Value,", ")	Возвращает значение типа Строка , содержащее значения многозначного параметра, разделенные точкой с запятой. Во втором параметре можно использовать любой разделитель для соединения.

Дополнительные сведения об использовании параметров в фильтре см. в разделе "Параметры отчета" (построитель отчетов и конструктор отчетов).

Связанный контент

Выражения (построитель отчетов)
Часто используемые фильтры (построитель отчетов)
Добавление, изменение или удаление параметра отчета (построитель отчетов)
Руководство. Добавление параметра в отчет (построитель отчетов)
Учебники по построителю отчетов
Встроенные коллекции в выражениях (построитель отчетов)