• Artikel

Verwenden von Verweisen auf Parameterauflistungen in Ausdrücken (Report Builder 3.0 und SSRS)

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 (Berichts-Generator 3.0 und SSRS).

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 (Report Builder 3.0 und SSRS).

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.

HinweisHinweis

Sie können Berichtsdefinitionen (RDL) in Berichts-Generator 3.0 und im Berichts-Designer in Business Intelligence Development Studio 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 3.0 (SSRS) im Web auf microsoft.com.

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 Hinzufügen von Datasetfiltern, Datenbereichsfiltern und Gruppenfiltern (Report Builder 3.0 und SSRS).

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 höher.

=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 Parameter (Report Builder 3.0 und SSRS).