Scripts

Внимание!
Это описание - для старой версии дизайнера документов (AR).
В ближайшее время страница будет обновлена на описание настройки в FastReports.

Общие сведения

Раздел Scripts предназначен для добавления программной логики непосредственно в файл макета отчета.

Сам код по сути представляет собой единственный класс ReportScript, внутри которого размещаются соответствующие инструкции, методы, классы.

Это позволяет отчету быть самодостаточным: код из раздела выполняется в процессе формирования отчета.

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

Script (скрипт) - предназначена для написания логики на языках VB.NET, которая сохраняется непосредственно внутри файла определения отчета.

Основные возможности и назначение

• Автономность отчетов - скрипты позволяют создавать «самодостаточные» отчеты. В отличие от стандартного подхода с использованием «code-behind» (файлов .vb или .cs), код во вкладке Script компилируется в момент выполнения отчета, что позволяет изменять логику без пересборки всего приложения.
• Событийно-ориентированная модель - скрипты привязываются к конкретным событиям отчета или его секций. Для этого в редакторе предусмотрены выпадающие списки Object (объект) и Event (событие).
• Управление данными и макетом - через скрипты можно динамически изменять свойства элементов (например, скрывать поля, менять цвет текста), выполнять расчеты или программно подключать источники данных.

Работа с объектами и событиями

Во вкладке Script доступны следующие ключевые элементы управления:

• Object (объекты) - можно выбрать сам отчет (Report) или конкретные секции (например, Detail, PageHeader, GroupFooter).
• Event (события) - список событий зависит от выбранного объекта.
• Для секций часто используются: Format (подготовка данных), BeforePrint и AfterPrint.
• Для отчета в целом: ReportStart, DataInitialize, FetchData и ReportEnd.

Особенности использования VB.NET

• Синтаксис - используется стандартный синтаксис VB.NET.
• Типы отчетов - скрипты на VB.NET поддерживаются как в Section Reports, так и в Page/RDLX Reports.
• Интеграция с выражениями - в Page-отчетах методы, написанные во вкладке Script, можно вызывать напрямую из свойств контролов через конструкцию =Code.ИмяМетода().