Verwenden von Parametern in Ausdrücken

Artikel
12/15/2008

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

(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.

= 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

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`

Ü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

Freigeben über

Verwenden von Parametern in Ausdrücken

Einwertige Parameter

Verwenden von einwertigen Parametern in Ausdrücken

Festlegen eines Filters mithilfe eines einwertigen Parameters

Mehrwertige Parameter

Verwenden eines mehrwertigen Parameters in einem Ausdruck

Festlegen eines Filters mithilfe eines mehrwertigen Parameters

Beispiele für das Verweisen auf Parameter in benutzerdefiniertem Code

Siehe auch

Aufgaben

Verweis

Konzepte

Andere Ressourcen

Hilfe und Informationen

Zusätzliche Ressourcen