Freigeben über


Verwenden von Parametern in Ausdrücken

Neu: 17. Juli 2006

Dieses Thema enthält eine Reihe von Beispielen für die Syntax, die Sie zum Verweisen auf Berichtsparameter in Ausdrücken benötigen. Berichtsparameter gehören zu den globalen Auflistungen, auf die Sie aus einem Ausdruck heraus verweisen können. Weitere Informationen finden Sie unter Verwenden globaler Auflistungen in Ausdrücken (Reporting Services).

Parameter werden beim Verarbeiten eines Berichts ausgewertet. Ausdrücke können an beliebiger Stelle in einer Eigenschaft eines Berichtselements oder Textfeldes verwendet werden, das die Optionen (Fx-) oder <Expression> bereitstellt. Beispiele für die Verwendungsmöglichkeiten von Ausdrücken finden Sie unter Beispiele für Ausdrücke in Reporting Services.

Berichtsparameter können einen der folgenden Typen aufweisen: Boolean, DateTime, Integer, Float oder String. Berichtsparameter sind ein- oder mehrwertig. Sie können für alle Typen außer Boolean die mehrwertige Eigenschaft festlegen. Ein mehrwertiger Parameter ist ein nullbasiertes Array von Werten. Weitere Informationen zum Festlegen von Berichtseigenschaften finden Sie unter Erstellen von Berichtsparametern und Festlegen von Berichtsparametereigenschaften.

Einwertige Parameter

Die folgende Tabelle enthält Beispiele für die Verwendung von einwertigen Parametern in Ausdrücken.

Verwenden von einwertigen Parametern in Ausdrücken

Die folgenden 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.

Festlegen eines Filters mithilfe eines einwertigen Parameters

Filter werden über die Registerkarte Filter der Eigenschaftenseiten der Datasets, Datenbereiche oder Datengruppierungen festgelegt. Der Filterausdruck wird auf der Registerkarte Filter durch Eingeben von Werten in das Filterraster definiert. Die folgende Tabelle stellt das Filterraster dar. Beim folgenden Beispiel wird angenommen, dass die Werte für Fields!EmployeeID.Value und Parameters!EmployeeID.Value den gleichen Datentyp aufweisen.

(Filter-)Ausdruck Operator Wert Und/Oder

= Fields!<FieldName>.Value

Ein beliebiger Operator, der zwei Werte vergleicht. z. B.:

=

>=

<

=Parameters!<ParameterName>.Value

Vordefinierter Wert, der aktiviert wird, wenn Sie mehrere Ausdrücke eingeben.

Mehrwertige Parameter

Die folgende Tabelle enthält Beispiele für die Verwendung von mehrwertigen Parametern in Ausdrücken.

Verwenden eines mehrwertigen Parameters in einem Ausdruck

Ausdrücke können an beliebiger Stelle in einer Eigenschaft eines Berichtselements oder Textfeldes verwendet werden, das die Optionen (Fx-) oder <Expression> bereitstellt.

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 Zeichenfolge zurück, die eine Liste von durch Kommas getrennten Werten in einem mehrwertigen Parameter enthält. Sie können ein beliebiges Trennzeichen im zweiten Parameter von Join verwenden.

Festlegen eines Filters mithilfe eines mehrwertigen Parameters

Filter werden über die Registerkarte Filter der Eigenschaftenseiten der Datasets, Datenbereiche oder Datengruppierungen festgelegt. Beim folgenden Beispiel wird angenommen, dass die Werte für Fields!EmployeeID.Value und Parameters!EmployeeID.Value den gleichen Datentyp aufweisen. Mehrwertige Parameter können nur in der Value-Spalte angezeigt werden.

Ausdruck Operator Wert Und/Oder

= Fields!<FieldName>.Value

Ein Operator, der auf Enthaltensein in einer Menge prüft. Die einzige verfügbare Auswahl ist IN.

=Parameters!<MultivalueParameterName>.Value

Vordefinierter Wert, der festgelegt wird, wenn Sie mehrere Ausdrücke eingeben.

Beispiele für das Verweisen auf Parameter in benutzerdefiniertem Code

Sie können auf die globale Parameters-Auflistung per benutzerdefinierten Code über einen Codeblock der Berichtsdefinition oder über eine von Ihnen bereitgestellte benutzerdefinierte Assembly verweisen. Die Parameters-Auflistung ist schreibgeschützt und verfügt über keine öffentlichen Iteratoren. Es ist nicht möglich, die Auflistung mit einer Visual Basic-For Each-Konstruktion zu durchlaufen. Sie benötigen den in einer Berichtsdefinition definierten Namen des Parameters, um auf ihn in Ihrem Code verweisen zu können. Allerdings ist es möglich, durch alle Werte eines mehrwertigen Parameters zu iterieren. Weitere Informationen finden Sie unter Verwenden von benutzerdefinierten Codeverweisen in Ausdrücken (Reporting Services).

Beschreibung Verweis in Ausdruck Benutzerdefinierte Codedefinition

Übergeben der gesamten globalen Parameters-Auflistung an benutzerdefinierten Code. Diese Funktion gibt den Wert eines bestimmten Berichtsparameters MyParameter zurück.

=Code.DisplayAParameterValue(Parameters)

Public Function DisplayAParameterValue(

ByVal parameters as Parameters) as Object

Return parameters("MyParameter").Value

End Function

Übergeben eines einzelnen Parameters an benutzerdefinierten Code. In diesem Beispiel wird der Wert des übergebenen Parameters zurückgegeben. Wenn es sich bei dem Parameter um einen mehrwertigen Parameter handelt, besteht die zurückgegebene Zeichenfolge aus einer Verkettung aller Werte.

=Code.ShowParametersValues(Parameters!DayOfTheWeek)

Public Function ShowParameterValues(ByVal parameter as Parameter)
 as String
   Dim s as String 
   If parameter.IsMultiValue then
      s = "Multivalue: " 
      For i as integer = 0 to parameter.Count-1
         s = s + CStr(parameter.Value(i)) + " " 
      Next
   Else
      s = "Single value: " + CStr(parameter.Value)
   End If
   Return s
End Function

Siehe auch

Aufgaben

Vorgehensweise: Hinzufügen, Bearbeiten oder Löschen eines Berichtsparameters (Berichts-Designer)

Verweis

Beispiele für Ausdrücke in Reporting Services

Konzepte

Verwenden von einwertigen und mehrwertigen Parametern

Andere Ressourcen

Using Custom Assemblies with Reports
Lernprogramm: Hinzufügen von Parametern zu einem einfachen Tabellenbericht
Lernprogramm: Erweiterte Features und Parameter

Hilfe und Informationen

Informationsquellen für SQL Server 2005