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.
.gif "Hinweis") 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 Berichts-Generator (SSRS) im Web auf microsoft.com. |
Syntax
RunningValue(expression, function, scope)
Parameter
expression
Der Ausdruck, für den die Aggregation auszuführen ist. Beispiel: [Quantity]function
(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 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. Durch Nothing wird der äußerste Kontext angegeben, normalerweise das Berichtsdataset.
Rückgabetyp
Wird durch die im function-Parameter angegebene Aggregatfunktion bestimmt.
Hinweise
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 kann kein Ausdruck sein.
Das Expression-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 unterschiedlichen 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.
Das Expression-Objekt darf die Funktionen First, Last, Previous oder RunningValue nicht enthalten.
Das Expression-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 finden Sie unter RowNumber-Funktion (Berichts-Generator und SSRS).
Weitere Informationen finden Sie unter Aggregatfunktionsreferenz (Berichts-Generator und SSRS) und Ausdrucksbereich für Gesamtwerte, Aggregate und integrierte Auflistungen (Berichts-Generator und SSRS).
Weitere Informationen zu rekursiven Aggregaten finden Sie unter Erstellen von rekursiven Hierarchiegruppen (Berichts-Generator und SSRS).
Beschreibung
Das folgende Codebeispiel generiert eine laufende Summe für das Feld mit dem Namen Cost im äußersten Bereich, den das Dataset darstellt.
Code
=RunningValue(Fields!Cost.Value, Sum, Nothing)
Siehe auch
Verweis
Beispiele für Ausdrücke (Berichts-Generator und SSRS)
Konzepte
Ausdrucksverwendungen in Berichten (Berichts-Generator und SSRS)