Funktionen von Berichts-Generator: RunningValue-Funktion in einem paginierten Bericht (Berichts-Generator)

Gilt für: Microsoft Report Builder (SSRS) Power BI Report Builder Report Designer in SQL Server Data Tools

Die Funktion gibt ein laufendes Aggregat aller numerischen Werte ungleich NULL aus dem angegebenen Ausdruck für den Kontext des angegebenen Bereichs in einem paginierten Bericht ausgewertet zurück.

Hinweis

Sie können paginierte Berichtsdefinitionsdateien (.rdl) im Berichts-Generator von Microsoft, im Power BI Report Builder und im Berichts-Designer in SQL Server-Datentools erstellen und ändern.

Syntax

  
RunningValue(expression, function, scope)  

Parameter

expression
Der Ausdruck, für den die Aggregation auszuführen ist, z.B. [Quantity].

Funktion
(Enum) Der Name der Aggregatfunktion, die auf den Ausdruck angewendet werden soll. Beispiel: Sum. Diese Funktion kann nicht RunningValue, RowNumberoder Aggregatesein.

scope
(String) Eine Zeichenfolgenkonstante als Name eines Datasets, eines Datenbereichs oder einer Gruppe oder NULL (Nothing in Visual Basic), der den Kontext angibt, in dem die Aggregation ausgewertet wird. DurchNothing wird der äußerste Kontext angegeben, normalerweise das Berichtsdataset.

Rückgabetyp

Wird durch die im function -Parameter angegebene Aggregatfunktion bestimmt.

Bemerkungen

Der Wert für RunningValue wird für jede neue Instanz des Bereichs auf 0 zurückgesetzt. Wenn eine Gruppe angegeben wird, wird der laufende Wert zurückgesetzt, wenn sich der Gruppenausdruck ändert. Wenn ein Datenbereich angegeben wird, wird der laufende Wert für jede neue Instanz des Datenbereichs zurückgesetzt. Wenn ein Dataset angegeben wird, wird der laufende Wert für das gesamte Dataset nicht zurückgesetzt.

RunningValue darf nicht in einem Filter- oder Sortierausdruck verwendet werden.

Der Datensatz, für den der ausgeführte Wert berechnet wird, muss den gleichen Datentyp aufweisen. Um Daten mit mehreren numerischen Datentypen in den gleichen Datentyp zu konvertieren, verwenden Sie Konvertierungsfunktionen wie CInt, CDbl oder CDec. Weitere Informationen finden Sie unter Funktionen für die Typkonvertierung.

Scope darf kein Ausdruck sein.

DasExpression -Objekt kann Aufrufe von geschachtelten Aggregatfunktionen enthalten. Dabei gelten folgende Ausnahmen und Bedingungen:

• Der Bereich für geschachtelte Aggregate muss dem Bereich des äußeren Aggregats entsprechen oder darin enthalten sein. In allen eindeutigen Bereichen des Ausdrucks muss ein Bereich eine untergeordnete Beziehung zu allen anderen Bereichen haben.

• Der Bereich für geschachtelte Aggregate darf nicht der Name eines Datasets sein.

• DasExpression -Objekt darf die Funktionen First, Last, Previousoder RunningValue nicht enthalten.

• DasExpression -Objekt darf keine geschachtelten Aggregate enthalten, die ein recursive-Objekt angeben.

Verwenden Sie RowNumberzur Berechnung des laufenden Werts für die Zeilenanzahl. Weitere Informationen dazu finden Sie unter RowNumber-Funktion (Berichts-Generator und SSRS).

Weitere Informationen finden Sie in der Aggregatfunktionsreferenz (Berichts-Generator und SSRS) und unter Ausdrucksbereich für Gesamtwerte, Aggregate und integrierte Auflistungen (Berichts-Generator und SSRS).

Weitere Informationen zu rekursiven Aggregaten finden Sie unter Erstellen rekursiver Hierarchiegruppen (Berichts-Generator und SSRS).

Beispiele

Das folgende Codebeispiel generiert eine laufende Summe für das Feld mit dem Namen Cost im äußersten Bereich, den das Dataset darstellt.

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

Das folgende Codebeispiel generiert eine laufende Summe für das Feld mit dem Namen Score im Dataset mit dem Namen DataSet1.

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

Das folgende Codebeispiel generiert eine laufende Summe für das Feld mit dem Namen Traffic Charges im äußersten Bereich.

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

Weitere Informationen

Ausdrucksverwendungen in Berichten (Berichts-Generator und SSRS)
Beispiele für Ausdrücke (Berichts-Generator und SSRS)
Datentypen in Ausdrücken (Berichts-Generator und SSRS)
Ausdrucksbereich für Gesamtwerte, Aggregate und integrierte Auflistungen (Berichts-Generator und SSRS)