Scripts: различия между версиями

Версия от 09:04, 13 октября 2026

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

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

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

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

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

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

@@ Строка 12: / Строка 12: @@
 Внутри раздела можно создавать собственные вспомогательные функции для выполнения сложных вычислений прямо «на лету».
+'''Script''' (''скрипт'') - предназначена для написания логики на языках <code>VB.NET</code>, которая сохраняется непосредственно внутри файла определения отчета.
+===Основные возможности и назначение===
+*'''Автономность отчетов''' - скрипты позволяют создавать «самодостаточные» отчеты. В отличие от стандартного подхода с использованием «code-behind» (файлов .vb или .cs), код во вкладке <code>Script</code> компилируется в момент выполнения отчета, что позволяет изменять логику без пересборки всего приложения.
+*'''Событийно-ориентированная модель''' - скрипты привязываются к конкретным событиям отчета или его секций. Для этого в редакторе предусмотрены выпадающие списки  <code>Object</code> (объект) и <code>Event</code> (событие).
+*'''Управление данными и макетом''' - через скрипты можно динамически изменять свойства элементов (например, скрывать поля, менять цвет текста), выполнять расчеты или программно подключать источники данных.
+===Работа с объектами и событиями===
+Во вкладке <code>Script</code> доступны следующие ключевые элементы управления:
+*'''Object''' (''объекты'') - можно выбрать сам отчет (<code>Report</code>) или конкретные секции (например, <code>Detail</code>, <code>PageHeader</code>, <code>GroupFooter</code>).
+*'''Event''' (''события'') - список событий зависит от выбранного объекта.
+*'''Для секций''' часто используются: <code>Format</code> (подготовка данных), <code>BeforePrint</code> и <code>AfterPrint</code>.
+*'''Для отчета''' в целом: <code>ReportStart</code>, <code>DataInitialize</code>, <code>FetchData</code> и <code>ReportEnd</code>.
+===Особенности использования VB.NET===
+*'''Синтаксис''' - используется стандартный синтаксис <code>VB.NET</code>.
+*'''Типы отчетов''' - скрипты на <code>VB.NET</code> поддерживаются как в <code>Section Reports</code>, так и в <code>Page/RDLX Reports</code>.
+*'''Интеграция с выражениями''' - в Page-отчетах методы, написанные во вкладке <code>Script</code>, можно вызывать напрямую из свойств контролов через конструкцию <code>=Code.ИмяМетода()</code>.