Funktionen im Berichts-Generator: Sum-Funktion in einem paginierten Bericht (Berichts-Generator)

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

Gibt die Summe aller numerischen Werte zurück, die nicht NULL sind und durch den Ausdruck angegeben werden, der in dem angegebenen Bereich in einem paginierten Bericht ausgewertet wird.

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

  
Sum(expression, scope, recursive)  

Parameter

expression
(Integer oder Float) Der Ausdruck, für den die Aggregation ausgeführt werden soll.

scope
(Zeichenfolge) Optional. Der Name eines Datasets, einer Gruppe oder eines Datenbereichs mit den Berichtselementen, auf die die Aggregatfunktion anzuwenden ist. Wenn scope nicht angegeben ist, wird der aktuelle Bereich verwendet.

rekursiv
(Aufzählungstyp) Optional. Simple (Standard) oder RdlRecursive. Gibt an, ob die Aggregation rekursiv auszuführen ist.

Rückgabetyp

Gibt für Dezimalausdrücke einen Wert vom Typ Decimal und für alle anderen Ausdrücke einen Wert vom Typ Double zurück.

Bemerkungen

Die im Ausdruck angegebene Gruppe von Daten muss über den gleichen Datentyp verfügen. 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.

Der Wert des scope-Objekts muss eine Zeichenfolgenkonstante sein und darf kein Ausdruck sein. Für äußere Aggregate oder Aggregate, die keine anderen Aggregate angeben, muss das scope -Objekt auf den aktuellen Bereich oder einen enthaltenen Bereich verweisen. Für Aggregate von Aggregaten können geschachtelte Aggregate einen untergeordneten Gültigkeitsbereich angeben.

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

  • Der Geltungsbereich für geschachtelte Aggregate muss mit dem Geltungsbereich des äußeren Aggregats übereinstimmen oder in ihm enthalten sein. Für alle verschiedenen Bereiche im Ausdruck muss ein Bereich allen anderen Bereichen untergeordnet sein.

  • Scope für geschachtelte Aggregate darf nicht der Name eines Datensatzes sein.

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

  • Der Ausdruck darf keine geschachtelten Aggregate enthalten, die recursive angeben.

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

A. Summe der Einzelpostensummen

Die beiden folgenden Codebeispiele stellen eine Summe der Einzelposten-Gesamtbeträge in der Gruppe bzw. im Datenbereich Order bereit.

=Sum(Fields!LineTotal.Value, "Order")  
' or   
=Sum(CDbl(Fields!LineTotal.Value), "Order")  

B. Maximalwert aus allen geschachtelten Regionen

In einem Matrixdatenbereich mit den geschachtelten Zeilengruppen "Kategorie" und "Unterkategorie" und den geschachtelten Spaltengruppen "Jahr" und "Quartal" wertet der folgende Ausdruck in einer Zelle, die zu den innersten Zeilen- und Spaltengruppen gehört, den maximalen Wert der Quartale für alle Unterkategorien aus.

=Max(Sum(Fields!Sales.Value))