Funkcje programu Report Builder — funkcja RunningValue w raporcie podzielonym na strony (Report Builder)

Dotyczy: Microsoft Report Builder (SSRS) Power BI Report Builder Projektant raportów w narzędziu SQL Server Data Tools

Zwraca bieżącą agregację wszystkich wartości liczbowych nie będących wartością null określonych przez wyrażenie dla danego zakresu w raporcie stronicowanym.

Składnia

  
RunningValue(expression, function, scope)  

Parametry

expression
Wyrażenie, na którym ma być wykonywana agregacja, na przykład [Quantity].

funkcja
(Enum) Nazwa funkcji agregującej, która ma być stosowana do wyrażenia, na przykład, Sum. Ta funkcja nie może mieć wartości RunningValue, RowNumber ani Aggregate.

zakres
(Ciąg) Stała ciągu, która jest nazwą zestawu danych, regionu danych lub grupy lub wartości null (Nic w Visual Basic), który określa kontekst, w którym ma być obliczana agregacja. Nothing odnosi się do najbardziej zewnętrznego kontekstu, zwykle jest to zestaw danych raportu.

Zwracany typ

Określana przez funkcję agregacji, która jest określona w parametrze funkcji .

Uwagi

Wartość elementu RunningValue resetuje wartość 0 dla każdego nowego wystąpienia zakresu. Jeśli zostanie określona grupa, wartość bieżąca zostanie zresetowana, gdy zmieni się wyrażenie grupy. Jeśli określono region danych, wartość bieżąca zostanie zresetowana dla każdego nowego wystąpienia regionu danych. Jeśli zostanie określony zestaw danych, wartość bieżąca nie zostanie zresetowana w całym zestawie danych.

Parametr RunningValue nie może być używany w wyrażeniu filtru ani sortowania.

Zestaw danych, dla których obliczana jest wartość bieżąca, musi mieć ten sam typ danych. Aby przekonwertować dane, które mają wiele typów danych liczbowych na ten sam typ danych, użyj funkcji konwersji, takich jak CInt, CDbl lub CDec. Aby uzyskać więcej informacji, zobacz Funkcje konwersji typów.

Zakres nie może być wyrażeniem.

Wyrażenie może zawierać wywołania zagnieżdżonych funkcji agregujących z następującymi wyjątkami i warunkami:

• Zakres zagnieżdżonych agregacji musi być taki sam jak zakres agregacji zewnętrznej lub mieścić się w nim. W przypadku wszystkich odrębnych zakresów w wyrażeniu jeden zakres musi znajdować się w relacji podrzędnej ze wszystkimi innymi zakresami.

• Zakres zagnieżdżonych agregacji nie może być nazwą zestawu danych.

• Wyrażenie nie może zawierać funkcji First, Last, Previous lub RunningValue .

• Wyrażenie nie może zawierać zagnieżdżonych agregacji o charakterze rekursywnym.

Aby obliczyć wartość bieżącą liczby wierszy, użyj kolumny RowNumber. Aby uzyskać więcej informacji, zobacz RowNumber Function (Report Builder i SSRS).

Aby uzyskać więcej informacji, zapoznaj się z Odwołanie do funkcji agregujących (Report Builder i SSRS) i Zakres wyrażeń dla sum, agregacji i wbudowanych kolekcji (Report Builder i SSRS).

Aby uzyskać więcej informacji na temat cyklicznych agregacji, zobacz Creating Recursive Hierarchy Groups (Report Builder and SSRS) (Tworzenie grup hierarchii cyklicznych (Report Builder i SSRS).

Przykłady

Poniższy przykład kodu zawiera bieżącą sumę pola o nazwie Cost w najbardziej zewnętrznym zakresie, który jest zestawem danych.

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

Poniższy przykład kodu dostarcza sumę bieżącą pola o nazwie Score w zestawie danych o nazwie DataSet1.

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

Poniższy przykład kodu zawiera bieżącą sumę pola o nazwie Traffic Charges w najbardziej zewnętrznym zakresie.

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

Treści powiązane

• Wyrażenia używane w raportach (Report Builder i SSRS)
• Przykłady wyrażeń (Report Builder i SSRS)
• Typy danych w wyrażeniach (Report Builder i SSRS)
• Zakres wyrażeń dla sum, agregacji i wbudowanych kolekcji (Report Builder i SSRS)