Функции построителя отчетов — функция RunningValue в отчете с разбивкой на страницы (построитель отчетов)

Применяется к: Microsoft Report Builder (SSRS) Power BI Report Builder Конструктор отчетов в SQL Server Data Tools

Возвращает накопительное агрегатное значение всех отличных от NULL числовых значений, заданных выражением и вычисленных для данной области действия в отчете с разбивкой на страницы.

Примечание.

Файлы определения страничных отчетов (.rdl) можно создавать и изменять в Microsoft Report Builder, Power BI Report Builder и в конструктор отчетов в SQL Server Data Tools.

Синтаксис

  
RunningValue(expression, function, scope)

Параметры

выражение
Выражение, по которому выполняется агрегирование, например [Quantity].

function
(Enum) Имя агрегата функции для применения к выражению, например Sum. Этой функцией не может быть RunningValue, RowNumberили Aggregate.

область применения
(String) Строковая константа, определяющая контекст вычисления агрегата в формате имени набора данных, региона данных или группы. Может принимать значение NULL (или Nothing в Visual Basic). ЗначениеNothing указывает самый внешний контекст, обычно набор данных отчета.

Тип возвращаемых данных

Определяется агрегатной функцией, указанной параметром function .

Замечания

Значение RunningValue сбрасывается до 0 при каждом новом экземпляре области. Если задана группа, текущее значение сбрасывается, когда изменяется выражение группы. Если указана область данных, то текущее значение сбрасывается для каждого нового экземпляра области данных. Если указан набор данных, то текущее значение не сбрасывается по всему набору данных.

ФункцияRunningValue не может быть использована в выражении фильтра или сортировки.

Набор данных, для которого вычислено текущее значение, должен иметь такой же тип данных. Чтобы преобразовать данные, имеющие разные числовые типы, к одному и тому же типу, используйте функции преобразования, такие как CInt, CDbl или CDec. Дополнительные сведения см. в разделе Функции преобразования типов.

Scope не может быть выражением.

Expression может содержать вызовы вложенных агрегатных функций со следующими условиями и исключениями.

  • Область действия для вложенных агрегатов должна совпадать с областью действия внешнего агрегата или входить в неё. Среди всех различных областей видимости в выражении одна область видимости должна быть дочерней по отношению ко всем остальным областям видимости.

  • Область действия для вложенных агрегатов не может быть именем набора данных.

  • Expression не может содержать функции First, Last, Previousи RunningValue .

  • Expression не может содержать вложенные агрегаты, в которых указан параметр recursive.

Для вычисления текущего значения числа строк используйте функцию RowNumber. Дополнительные сведения см. в разделе Функция RowNumber (построитель отчетов и службы SSRS).

Дополнительные сведения см. в разделах Справочник по агрегатным функциям (построитель отчетов и SSRS) и Область выражения для суммирования, агрегатных функций и встроенных коллекций (построитель отчетов и SSRS).

Дополнительные сведения о рекурсивных статистических выражениях см. в разделе Создание групп рекурсивной иерархии (построитель отчетов и SSRS).

Примеры

Следующий пример кода показывает накопительную сумму поля с именем Cost в самой внешней области видимости, то есть набора данных.

=RunningValue(Fields!Cost.Value, Sum, Nothing)

Следующий пример кода вычисляет накопительную сумму для поля с именем Score в наборе данных с именем DataSet1.

=RunningValue(Fields!Score.Value,sum,"DataSet1")

В следующем примере кода показана накопительная сумма для поля с именем Traffic Charges в самой внешней области видимости.

=RunningValue(Fields!Traffic Charges.Value, Sum, Nothing)

Связанный контент

  • Last updated on