Verwenden von Ausdrücken in einem Bericht (Visual Studio-Berichts-Designer)
Sie können Microsoft Visual Basic-Ausdrücke in ReportViewer-Berichte einschließen. Mithilfe von Ausdrücken können Sie den Wert eines Berichtselements berechnen oder Werte für Stil- und Formatierungseigenschaften oder für andere Berichtselementeigenschaften berechnen. Sie können alle Visual Basic-Funktionen sowie integrierte Funktionen verwenden, die nur in Berichtsdefinitionsdateien unterstützt werden.
Weitere Informationen zu Ausdrücken, die häufig in ReportViewer-Berichten verwendet werden, finden Sie unter In Berichten häufig verwendete Ausdrücke (Visual Studio-Berichts-Designer).
Feldausdrücke
Der einfachste Ausdruckstyp dient dazu, einen Feldwert in einem Textfeld anzuzeigen. Dies wird als Feldausdruck bezeichnet. Um ein Berichtselement mit einem Datenfeld zu verknüpfen, muss der Ausdruck die Fields-Auflistung, den Namen des Felds und die Value-Eigenschaft einschließen. Der Wert wird automatisch erstellt, wenn Sie das Feld in den Bericht ziehen. Das folgende Beispiel zeigt einen Ausdruck, der einen Produktnamen in einem Textfeld anzeigt:
=Fields!Product.Value
Ein Ausdruck kann kurz sein und lediglich auf ein Feldobjekt verweisen, er kann jedoch auch komplex sein und Entscheidungsfunktionen oder die Formatierung basierend auf Feldern oder anderen Berichtselementen unterstützen. Ausdrücke in Berichtselementen und Eigenschaften müssen mit einem Gleichheitszeichen (=) beginnen. Wenn Sie den Text nicht mit diesem Zeichen beginnen, wird der Text als tatsächlicher Wert des Felds ausgewertet.
Nachstehend sind Beispiele für Feldausdrücke aufgeführt:
Dieser Ausdruck verkettet das Feld FirstName und das Feld LastName.
=Fields!FirstName.Value & " " & Fields!LastName.ValueDieser Ausdruck führt eine Summenaggregation über das Feld LineTotal aus.
=Sum(Fields!LineTotal.Value)
Weitere Informationen zur Fields-Auflistung finden Sie unter Globale Auflistungen für Ausdrücke in Berichten (Visual Studio-Berichts-Designer).
Bedingte Formatierung
Mithilfe von Ausdrücken können Sie die Darstellung eines Berichtselements steuern. So können Sie beispielsweise einen Ausdruck für die Color-Eigenschaft eines Textfelds erstellen, der die Daten in Abhängigkeit von ihren Werten in unterschiedlichen Farben anzeigt. Das folgende Beispiel verdeutlicht die bedingte Formatierung:
Wenn dieser Ausdruck in der Color-Eigenschaft eines Textfelds verwendet wird, wird der Wert rot angezeigt, wenn der Wert des Felds Cost größer als der Wert des Felds Revenue ist. Wenn die Bedingung nicht erfüllt wird, wird der Text schwarz angezeigt.
=IIf(Fields!Cost.Value > Fields!Revenue.Value, "Red", "Black")
Weitere Informationen zur bedingten Formatierung finden Sie unter Hinzufügen von Stil und Formatierung zu einem Bericht (Visual Studio-Berichts-Designer).
Reporting Services-Funktionen
Reporting Services stellt zahlreiche integrierte Funktionen bereit, die Sie in Ausdrücken verwenden können. Hierzu zählen Standardaggregatfunktionen wie Sum, Min, Max und Count sowie Funktionen wie RowNumber und RunningValue. Eine vollständige Liste der Funktionen mit den zugehörigen Beschreibungen finden Sie unter Integrierte Funktionen für Berichte (Visual Studio-Berichts-Designer).
Klassenverweise und benutzerdefinierter Code
Ausdrücke innerhalb eines Berichts können auch Verweise auf Klassen innerhalb der Namespaces Microsoft.VisualBasic, System.Convert und System.Math enthalten. Wenn Sie Klassen oder Funktionen aus anderen Systemnamespaces verwenden, müssen Sie den vollständigen Namespace angeben, z. B. System.Collections.ArrayList.
Wenn Sie zusätzliche Funktionalität benötigen, die nicht durch die Reporting Services-Funktionen oder durch die Standardklassen bereitgestellt wird, können Sie benutzerdefinierten Code, eine andere Standardassembly oder einen Berichtscodeblock verwenden. Hierzu erstellen Sie eine benutzerdefinierte Assembly und verweisen dann in einem Ausdruck auf diese Assembly. Weitere Informationen finden Sie unter Hinzufügen von benutzerdefiniertem Code zu einem Bericht (Visual Studio-Berichts-Designer).
Siehe auch
Konzepte
ReportViewer-Steuerelemente (Visual Studio)
Übersicht über Berichte (Visual Studio)