RunningValue-Funktion (Berichts-Generator und SSRS)
Gibt ein laufendes Aggregat aller numerischen Werte ungleich NULL aus dem angegebenen Ausdruck für den Kontext des angegebenen Bereichs ausgewertet zurück.
Hinweis
Sie können Berichtsdefinitionen (RDL) in Berichts-Generator und im Berichts-Designer in SQL Server-Datentools erstellen und ändern. Jede Erstellungsumgebung bietet verschiedene Methoden zum Erstellen, Öffnen und Speichern von Berichten und verwandten Elementen. Weitere Informationen finden Sie unter Entwerfen von Berichten in Berichts-Designer und Report Builder (SSRS) im Web unter microsoft.com.
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
, RowNumber
oder Aggregate
sein.
scope
(String
) Eine Zeichenfolgenkonstante, die den Namen eines Datasets, eines Datenbereichs oder einer Gruppe oder null (Nothing
in Visual Basic) ist, die den Kontext angibt, in dem die Aggregation ausgewertet werden soll. Durch Nothing
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.
Ausdruck darf keine Funktionen ,
Last
,Previous
oderRunningValue
enthaltenFirst
.DasExpression -Objekt darf keine geschachtelten Aggregate enthalten, die ein recursive-Objekt angeben.
Verwenden Sie RowNumber
zur 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)