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

Выражения

Материал из Химсофт Вики

Выражение – это строка кода на языке C#, которая возвращает какое-либо значение.

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

Пример:

[2 + 2]

Редактор выражений

Редактор выражений - предназначен для удобства написания выражения и может вызываться в тех местах интерфейса дизайнера, где поддерживается ввод выражений.

Редактор выражений представляет собой окно, в котором можно ввести текст выражения и вставить в него элементы из окна Данные:

Обращение к объектам отчета

Пример 1. Высота объекта Text1 (обращение по имени):

Text1.Height

Пример 2. Имя файла, из которого был загружен отчет (использование переменной Report):

Report.FileName

Пример 3. Название отчета (обращение к вложенным свойствам объекта):

Report.ReportInfo.Name

Использование функций .NET

Вы можете использовать любые объекты .NET в выражениях.

Пример: использование функции Max:

Math.Max(5, 10)

Сборки .NET

По умолчанию отчет использует следующие сборки .NET:

System.dll
System.Drawing.dll
System.Windows.Forms.dll
System.Data.dll
System.Xml.dll

Вам доступны все объекты .NET, объявленные в этих сборках.

Если вам нужно получить доступ к другой сборке, добавьте ее название в список сборок отчета.

Это можно сделать в меню Отчет|Свойства…, выбрав в окне элемент Скрипт.

Например, если вы хотите использовать в отчете функцию, объявленную в вашем приложении, добавьте ссылку на сборку приложения (.exe или .dll) в список сборок отчета.

Обращение к функциям

После этого можно обращаться к функции, используя пространство имени (namespace) вашего приложения. Например, если в приложении определена следующая функция:

namespace Demo
{
  public static class MyFunctions
  {
    public static string Func1()
    {
      return "Hello!";
    }
  }
}

Обратиться к ней в отчете можно так:

Demo.MyFunctions.Func1()

Если добавить в скрипт директиву using Demo, это позволит укоротить форму обращения к функции:

MyFunctions.Func1()

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

myPrivateVariableThatIHaveDeclaredInScript
MyScriptFunction()

Использовать в выражении можно функции, которые возвращают значение.

Обращение к данным отчета

Помимо стандартных языковых элементов, в выражениях можно использовать следующие элементы отчета:

  • поля источников данных;
  • системные переменные;
  • итоговые значения;
  • параметры отчета.

Все эти элементы содержатся в окне Данные.

Любой из этих элементов можно использовать в выражении, заключив его в квадратные скобки. Например:

[Page] + 1

Это выражение возвращает номер следующей печатаемой страницы.

В выражении используется системная переменная Page, которая возвращает номер текущей страницы отчета. Она заключена в квадратные скобки.

Обращение к источникам данных

Обращение к системным переменным

Обращение к итоговым значениям

Обращение к параметрам отчета