Использование в выражениях ссылок на коллекцию параметров (службы Reporting Services)
Параметры отчета являются одной из встроенных коллекций, на которые можно ссылаться из выражения. Включая в выражение параметры, можно настраивать внешний вид и данные отчета в соответствии с выбором пользователя. Выражения могут использоваться в любом свойстве элемента отчета или свойстве текстового поля, если те обладают параметром (Fx) или <Выражение>. Выражения применяются также для управления содержимым отчета и его внешним видом другими способами. Дополнительные сведения см. в разделе Примеры выражений (службы Reporting Services).
При сравнении значений параметра со значениями полей набора данных во время выполнения типы данных сравниваемых элементов должны совпадать. Параметры отчета могут относиться к одному из следующих типов: Boolean, DateTime, Integer, Float или Text, представляющий базовый тип данных String. При необходимости может понадобиться преобразовать тип данных параметра, чтобы он соответствовал значению набора данных. Дополнительные сведения см. в разделе Работа с типами данных в выражениях (службы Reporting Services).
Чтобы включить в выражение ссылку на параметр, следует понимать, как правильно указать ее синтаксис, который зависит от того, однозначный или многозначный параметр использован.
Использование в выражении однозначного параметра
В следующей таблице показаны примеры синтаксиса, применяемого при включении в выражение ссылки на однозначный параметр произвольного типа данных.
Пример |
Описание |
|---|---|
=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 |
Возвращает значение поля с таким же именем, как и у параметра. |
Дополнительные сведения об использовании параметров в фильтре см. в разделе Фильтрация данных отчета в отчете.
Использование многозначного параметра в выражении
В следующей таблице показаны примеры синтаксиса, применяемого при включении в выражение ссылки на многозначный параметр произвольного типа данных.
Пример |
Описание |
|---|---|
=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,", ") |
Возвращает строку, содержащую значения многозначного параметра, разделенные точкой с запятой. Во втором параметре можно использовать любой разделитель для соединения. |
Дополнительные сведения об использовании параметров в фильтре см. в разделе Фильтрация данных отчета в отчете.
См. также
Задания
Как добавить, изменить или удалить параметр отчета (службы Reporting Services)
Справочник
Примеры выражений (службы Reporting Services)
Применение встроенных коллекций в выражениях (службы Reporting Services)
Основные понятия
Использование однозначных и многозначных параметров
Учебник. Добавление параметров в отчет
Создание параметров отчета и настройка свойств параметров отчета