Параметры

Параметр – это переменная, значение которой может быть определено как в самом отчете, так и вне его (программа, вызывающая отчет, может передавать в него значения параметров).

Параметр может использоваться в выражениях, выводиться в объектах типа Текст.

Наиболее частые способы использования параметров

фильтрация данных по условию, заданному в параметре;
печать значения параметра в отчете.

Свойства параметров

Свойство	Описание
`Name`	Имя параметра может содержать любые символы, кроме точки `.`.
`DataType`	Тип данных параметра.
`Expression`	Выражение, которое возвращает значение параметра. Подробнее о выражениях смотрите в главе `Выражения`. Это выражение будет вычислено при обращении к параметру.
`Value`	Значение параметра. Это свойство недоступно в дизайнере и может быть заполнено программным способом.

Вы должны настроить свойства Name и DataType.

Свойство Expression можно оставить пустым. В этом случае значение параметра надо передавать программным способом.

Создание параметра

Чтобы создать параметр, выберите элемент Параметры отчета в окне Данные и выберите пункт Новый параметр в контекстном меню:

Нажмите клавишу F2 и задайте желаемое имя параметра, затем переключитесь в окно Свойства и укажите тип данных параметра (свойство DataType).

Параметры могут быть вложенными. Чтобы создать вложенный параметр, выберите родительский параметр и выберите пункт Новый параметр в контекстном меню:

При этом можно обращаться как к родительскому параметру, так и к вложенному.

Количество уровней вложенности не ограничено.

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

Простой параметр

К параметру можно обращаться из выражения, используя квадратные скобки:

[Имя параметра]

Вложенный параметр

К вложенному параметру надо обращаться следующим образом:

[Родительский параметр.Дочерний параметр]

Строковый параметр

Так как параметр имеет определенный тип (он задан в свойстве DataType), с параметром можно выполнять действия, разрешенные для типа данных.

Так, параметры строкового типа можно использовать в выражении следующим образом:

[Строковый параметр].Substring(0, 2)

Пример

Существует отчет, печатающий таблицу Employees (Сотрудники).
Требуется распечатать информацию о сотруднике с указанным номером (поле EmployeeID).
Для этого нужно создать параметр с именем Номер сотрудника.
Укажем тип параметра – Int32, так как именно этот тип имеет поле EmployeeID.

Чтобы отфильтровать сотрудника с указанным номером, нужно зайти в редактор бэнда Данные и на закладке Фильтр указать следующее выражение:

[Employees.EmployeeID] == [Номер сотрудника]

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

Report.SetParameterValue("Номер сотрудника", 2);