Verwenden von Verweisen auf Parameters-Auflistungen in Ausdrücken (Reporting Services)
Berichtsparameter gehören zu den integrierten Auflistungen, auf die Sie aus einem Ausdruck heraus verweisen können. Indem Sie Parameter in einen Ausdruck einschließen, können Sie die Berichtsdaten und die Darstellung von Berichten anhand der Auswahlen eines Benutzers anpassen. Ausdrücke können für jede Eigenschaft eines Berichtselements oder Textfelds verwendet werden, das die Optionen (Fx) oder <Ausdruck> bereitstellt. Ausdrücke werden auch zum Steuern des Berichtsinhalts und der Darstellung eines Berichts auf andere Weise verwendet. Weitere Informationen finden Sie unter Beispiele für Ausdrücke (Reporting Services).
Wenn Sie Parameterwerte mit Dataset-Feldwerten zur Laufzeit vergleichen, müssen die Datentypen der beiden verglichenen Elemente identisch sein. Berichtsparameter können einen der folgenden Typen aufweisen: Boolean, DateTime, Integer, Float oder Text (steht für den zugrunde liegenden Datentyp String). Es kann erforderlich sein, dass Sie den Datentyp des Parameterwerts konvertieren, damit er dem Datasetwert entspricht. Weitere Informationen finden Sie unter Arbeiten mit Datentypen in Ausdrücken (Reporting Services).
Wenn Sie einen Parameterverweis in einen Ausdruck einfügen möchten, müssen Sie wissen, wie die korrekte Syntax für den Parameterverweis angegeben wird. Diese variiert je nachdem, ob der Parameter ein ein- oder mehrwertiger Parameter ist.
Verwenden von einwertigen Parametern in Ausdrücken
Die folgende Tabelle enthält Beispiele für die zu verwendende Syntax zum Verweisen auf einwertige Parameter beliebigen Datentyps in einem Ausdruck.
Beispiel: |
Beschreibung |
|---|---|
=Parameters!<ParameterName>.IsMultiValue |
Gibt False zurück. Überprüft, ob ein Parameter mehrwertig ist. Wenn True zurückgegeben wird, ist der Parameter mehrwertig und stellt eine Auflistung von Objekten dar. Wenn False zurückgegeben wird, ist der Parameter einwertig und stellt ein einzelnes Objekt dar. |
=Parameters!<ParameterName>.Count |
Gibt den Ganzzahlwert 1 zurück. Für einwertige Parameter ist der Wert stets 1. |
=Parameters!<ParameterName>.Label |
Gibt die Parameterbezeichnung zurück, die häufig als Anzeigename in einer Dropdownliste der verfügbaren Werte verwendet wird. |
=Parameters!<ParameterName>.Value |
Gibt den Parameterwert zurück. Wenn die Label-Eigenschaft nicht festgelegt ist, wird dieser Wert in der Dropdownliste der verfügbaren Werte angezeigt. |
=CStr(Parameters! <ParameterName>.Value) |
Gibt den Parameterwert als Zeichenfolge zurück. |
=Fields(Parameters!<ParameterName>.Value).Value |
Gibt den Wert für das Feld zurück, das den gleichen Namen wie der Parameter besitzt. |
Weitere Informationen über das Verwenden von Parametern in einem Filter finden Sie unter Filtern von Berichtsdaten im Bericht.
Verwenden eines mehrwertigen Parameters in einem Ausdruck
Die folgende Tabelle enthält Beispiele für die zu verwendende Syntax zum Verweisen auf mehrwertige Parameter beliebigen Datentyps in einem Ausdruck.
Beispiel: |
Beschreibung |
|---|---|
=Parameters!<MultivalueParameterName>.IsMultiValue |
Gibt True oder False zurück. Überprüft, ob ein Parameter mehrwertig ist. Wenn True zurückgegeben wird, ist der Parameter mehrwertig und stellt eine Auflistung von Objekten dar. Wenn False zurückgegeben wird, ist der Parameter einwertig und stellt ein einzelnes Objekt dar. |
=Parameters!<MultivalueParameterName>.Count |
Gibt eine ganze Zahl zurück. Bezieht sich auf die Anzahl der Werte. Für einwertige Parameter ist der Wert stets 1. Für mehrwertige Parameter ist der Wert 0 oder größer als 0. |
=Parameters!<MultivalueParameterName>.Value(0) |
Gibt den ersten Wert eines mehrwertigen Parameters zurück. |
=Parameters!<MultivalueParameterName>.Value(Parameters!<MultivalueParameterName>.Count-1) |
Gibt den letzten Wert eines mehrwertigen Parameters zurück. |
=Split("Value1,Value2,Value3",",") |
Gibt ein Array von Werten zurück. Erstellt ein Array von Werten für einen mehrwertigen String-Parameter. Sie können ein beliebiges Trennzeichen im zweiten Parameter von Split verwenden. Mit diesem Ausdruck können Standardwerte für einen mehrwertigen Parameter festgelegt werden oder ein mehrwertiger Parameter zum Senden an einen Unterbericht oder Drillthroughbericht erstellt werden. |
=Join(Parameters!<MultivalueParameterName>.Value,", ") |
Gibt eine String zurück, die eine Liste von durch Trennzeichen getrennten Werten in einem mehrwertigen Parameter enthält. Sie können ein beliebiges Trennzeichen im zweiten Parameter von Join verwenden. |
Weitere Informationen über das Verwenden von Parametern in einem Filter finden Sie unter Filtern von Berichtsdaten im Bericht.
Siehe auch
Aufgaben
Vorgehensweise: Hinzufügen, Ändern oder Löschen von Berichtsparametern (Reporting Services)
Verweis
Beispiele für Ausdrücke (Reporting Services)
Verwenden integrierter Auflistungen in Ausdrücken (Reporting Services)
Konzepte
Verwenden von ein- und mehrwertigen Parametern
Lernprogramm: Hinzufügen von Parametern zu einem Bericht
Erstellen von Berichtsparametern und Festlegen von Berichtsparametereigenschaften