Параметры

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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