Ausdruck (Dialogfeld) (Berichts-Generator)

Artikel
09/10/2013

Verwenden Sie das Dialogfeld Ausdruck, um Microsoft Visual Basic-Ausdrücke für Berichtselementeigenschaften zu schreiben. Mit Ausdrücken können Sie zahlreiche Eigenschaften wie Farbe, Schriftart und Rahmen festlegen. Zur Laufzeit werden die Ausdrücke vom Berichtsprozessor ausgewertet, und das Ergebnis wird durch den Wert der Eigenschaft ersetzt.

Das Dialogfeld Ausdruck enthält ein Codefenster, eine Kategoriestruktur, Kategorieelemente, einen Beschreibungsbereich sowie einen Beispielbereich. Das Dialogfeld Ausdruck ist kontextbezogen. Die Kategorieelemente und Beschreibungen verändern sich je nach verwendeter Ausdruckskategorie. Weitere Informationen finden Sie unter Beispiele für Ausdrücke (Berichts-Generator und SSRS), Ausdrücke (Berichts-Generator und SSRS).

Ausdruckskonstrukte

Ausdrücke beginnen mit einem Gleichheitszeichen (=) und können Konstanten, Literale, Operatoren und Verweise auf integrierte Felder, Auflistungen und Funktionen, Visual Basic-Laufzeitbibliotheksfunktionen, .NET Framework-CLR-Klassen (Common Language Runtime) sowie benutzerdefinierte Funktionen enthalten. Die folgende Liste beschreibt die Kategorien und Werte, die Sie einem Ausdruck hinzufügen können.

Ausdruck festlegen für: <PropertyName>
Der Name der Eigenschaft, für die Sie einen Ausdruck definieren. Sie können diese Einstellung auch im Eigenschaftenfenster nach dem Namen vornehmen.
Konstanten
Stellt für Eigenschaften, die auf Konstanten basieren, eine Liste vordefinierter gültiger Werte für diese Eigenschaft bereit. Beispielsweise zeigt eine Eigenschaft auf Grundlage der Farbe gültige Farbnamen an. Für eine Eigenschaft, die einen booleschen Datentyp darstellt, lauten die Werte True und False.

Nicht alle Elemente, die Ausdrücke unterstützen, können auf eine Konstante festgelegt werden. Wenn eine Eigenschaft nicht auf einen konstanten Wert festgelegt werden kann, ist dies in der Beschreibung angegeben.
Integrierte Felder
Bietet eine Liste der in der globalen Auflistung enthaltenen Elemente, die Sie in einem Ausdruck verwenden können. Einige Auflistungen werden nur unterstützt, nachdem der Bericht auf dem Server veröffentlicht wurde. Weitere Informationen finden Sie unter Integrierte Auflistungen in Ausdrücken (Berichts-Generator und SSRS).
Parameter
Bietet eine Liste von Berichtsparametern.
Felder( <selected Dataset> )
Zeigt die Liste von Feldern für das in der Datasets-Kategorie ausgewählte Dataset an. Doppelklicken Sie auf ein Feld, um es in das Feld Ausdruck zu kopieren.
Datasets
Bietet eine Liste der verfügbaren Datasets und zeigt die Felder an, die Mitglied des Datasets sind.
Variablen
Zeigt eine Liste von Berichtsvariablen an. Weitere Informationen finden Sie unter Verweise auf Berichts- und Gruppenvariablenauflistungen (Berichts-Generator und SSRS).
Operatoren
Zeigt die Operatoren an, die Sie in einer Berechnung oder bei einer Zeichenfolgebearbeitung verwenden können. Weitere Informationen finden Sie unter Operatoren in Ausdrücken (Berichts-Generator und SSRS).
Allgemeine Funktionen
Zeigt allgemeine, nach Typ gruppierte Funktionen an. Wenn Sie im Bereich Element eine Funktion auswählen, werden eine Beschreibung und ein Beispiel angezeigt.

Zu den häufig verwendeten Funktionen gehören integrierte Berichts- und Aggregationsfunktionen, Visual Basic-Laufzeitbibliotheksfunktionen und .NET Framework Common Language Runtime (CLR)-Klassen im Math- und Convert-Namespace. Sie können auch Verweise auf CLR-Klassen und externe Assemblys hinzufügen, die nicht in der Kategorieliste angezeigt werden. Weitere Informationen finden Sie unter Benutzerdefinierter Code und Assemblyverweise in Ausdrücken in Berichts-Designer (SSRS).

Optionen

Codefenster
Im oben angezeigten Codefenster können Sie einen Ausdruck eingeben. Wenn Sie das Dialogfeld Ausdruck öffnen, enthält das Codefenster den Ausdruck. Sie können den Ausdruck ersetzen oder bearbeiten. Sie können Funktionsaufrufe, Operatoren, Konstanten, Felder, Parameter, Elemente aus den globalen Auflistungen sowie Verweise auf benutzerdefinierten Code hinzufügen. Das Codefenster zeigt Ihre Änderungen sofort an.

Ein geschwungener roter Unterstrich signalisiert einen Syntaxfehler. Zeigen Sie auf den unterstrichenen Text, um die Fehlermeldung einzublenden.

Wenn Sie Begriffe aus globalen Auflistungen, gefolgt von einem Interpunktionstrennzeichen, eingeben, wird eine Dropdownliste mit verfügbaren Mitgliedern oder Eigenschaften angezeigt. Geben Sie über die Dropdownliste die ersten Zeichen ein, gefolgt von einem Tabulator, um die Auswahl automatisch auszufüllen.

Wenn Sie einen Funktionsnamen, gefolgt von einer linken Klammer, eingeben, wird eine QuickInfo mit Informationen zu den Parametern und Rückgabewerten der Funktion angezeigt.
Kategorie
Zeigt Kategorien von Ausdrücken an. Durch Auswahl einer Kategorie wird ein Kontext für die Erstellung eines Ausdrucks bereitgestellt und die Liste der gültigen Werte im Bereich Element geändert. Für einen Ausdruck für einen Textfeldwert erweitern Sie beispielsweise Allgemeine Funktionen, und wählen Sie Aggregatfunktionen aus, um Avg, Count und andere Funktionen im Bereich Element anzuzeigen.
Element
Zeigt die Liste der gültigen Felder für die ausgewählte Kategorie an. Doppelklicken Sie auf ein Element, um den Ausdruckstext für dieses Element an der Einfügemarke im Codefenster hinzuzufügen.
Values
Abhängig von der ausgewählten Kategorie und dem Element enthält der dritte Bereich eine Beschreibung, einen Beispielausdruck oder eine Liste gültiger Werte. Ziehen Sie am Rand des Dialogfelds, um den Beispielbereich zu erweitern.