Перейти к содержанию

Script

Материал из Химсофт Вики
(перенаправлено с «Скрипты»)

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.ИмяМетода().