Integrierte Auflistungen: Verweise auf ParameterauflistungenBuilt-in Collections - Parameters Collection References (Report Builder)

Berichtsparameter gehören zu den integrierten Auflistungen, auf die Sie aus einem Ausdruck heraus verweisen können.Report parameters are one of the built-in collections you can reference from an expression. Indem Sie Parameter in einen Ausdruck einschließen, können Sie die Berichtsdaten und die Darstellung von Berichten anhand der Auswahlen eines Benutzers anpassen.By including parameters in an expression, you can customize report data and appearance based on choices a user makes. Ausdrücke können für jede Eigenschaft eines Berichtselements oder Textfelds verwendet werden, das die Optionen (Fx) oder <Ausdruck> bereitstellt.Expressions can be used for any report item property or text box property that provides the (Fx) or <Expression> option. Ausdrücke werden auch zum Steuern des Berichtsinhalts und der Darstellung eines Berichts auf andere Weise verwendet.Expressions are also used to control report content and appearance in other ways. Weitere Informationen finden Sie unter Beispiele für Ausdrücke (Berichts-Generator und SSRS).For more information, see Expression Examples (Report Builder and SSRS).

Wenn Sie Parameterwerte mit Dataset-Feldwerten zur Laufzeit vergleichen, müssen die Datentypen der beiden verglichenen Elemente identisch sein.When you compare parameter values with dataset field values at run time, the data types for the two items you are comparing must be the same. Berichtsparameter können einen der folgenden Typen aufweisen: Boolean, DateTime, Integer, Float oder Text (steht für den zugrunde liegenden Datentyp String).Report parameters can be one of the following types: Boolean, DateTime, Integer, Float, or Text, which represents the underlying data type String. Es kann erforderlich sein, dass Sie den Datentyp des Parameterwerts konvertieren, damit er dem Datasetwert entspricht.If necessary, you might have to convert the data type of the parameter value to match the dataset value. Weitere Informationen finden Sie unter Datentypen in Ausdrücken (Berichts-Generator und SSRS).For more information, see Data Types in Expressions (Report Builder and 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.In order to include a parameter reference in an expression, you must understand how to specify the correct syntax for the parameter reference, which varies depending on whether the parameter is a single-value or multivalue parameter.

Hinweis

Sie können paginierte Berichtsdefinitionsdateien (.rdl) im Berichts-Generator und im Berichts-Designer in SQL Server-Datentools erstellen und ändern.You can create and modify paginated report definition (.rdl) files in Report Builder and in Report Designer in SQL Server Data Tools. Jede Erstellungsumgebung bietet verschiedene Methoden zum Erstellen, Öffnen und Speichern von Berichten und verwandten Elementen.Each authoring environment provides different ways to create, open, and save reports and related items.

Verwenden von einwertigen Parametern in AusdrückenUsing a Single-Valued Parameter in an Expression

Die folgende Tabelle enthält Beispiele für die zu verwendende Syntax zum Verweisen auf einwertige Parameter beliebigen Datentyps in einem Ausdruck.The following table shows examples of the syntax to use when you include a reference to a single-value parameter of any data type in an expression.

BeispielExample BESCHREIBUNGDescription
=Parameters! <ParameterName> .IsMultiValue=Parameters! <ParameterName> .IsMultiValue Gibt Falsezurück.Returns False.

Überprüft, ob ein Parameter mehrwertig ist.Checks if a parameter is multivalue. Wenn Truezurückgegeben wird, ist der Parameter mehrwertig und stellt eine Auflistung von Objekten dar.If True, the parameter is multivalue and it is a collection of objects. Wenn FALSEzurückgegeben wird, ist der Parameter einwertig und stellt ein einzelnes Objekt dar.If False, the parameter is single-value and is a single object.
=Parameters! <ParameterName> .Count=Parameters! <ParameterName> .Count Gibt den Ganzzahlwert 1 zurück.Returns the integer value 1. Für einwertige Parameter ist der Wert stets 1.For a single-value parameter, the count is always 1.
=Parameters! <ParameterName> .Label=Parameters! <ParameterName> .Label Gibt die Parameterbezeichnung zurück, die häufig als Anzeigename in einer Dropdownliste der verfügbaren Werte verwendet wird.Returns the parameter label, frequently used as the display name in a drop-down list of available values.
=Parameters! <ParameterName> .Value=Parameters! <ParameterName> .Value Gibt den Parameterwert zurück.Returns the parameter value. Wenn die Label-Eigenschaft nicht festgelegt ist, wird dieser Wert in der Dropdownliste der verfügbaren Werte angezeigt.If the Label property has not been set, this value appears in the drop-down list of available values.
=CStr(Parameters! <ParameterName> .Value)=CStr(Parameters! <ParameterName> .Value) Gibt den Parameterwert als Zeichenfolge zurück.Returns the parameter value as a string.
=Fields(Parameters! <ParameterName> .Value).Value=Fields(Parameters! <ParameterName> .Value).Value Gibt den Wert für das Feld zurück, das den gleichen Namen wie der Parameter besitzt.Returns the value for the field that has the same name as the parameter.

Weitere Informationen zum Verwenden von Parametern in einem Filter finden Sie unter Hinzufügen von Datasetfiltern, Datenbereichsfiltern und Gruppenfiltern (Berichts-Generator und SSRS).For more information about using parameters in a filter, see Add Dataset Filters, Data Region Filters, and Group Filters (Report Builder and SSRS).

Verwenden eines mehrwertigen Parameters in einem AusdruckUsing a Multivalue Parameter in an Expression

Die folgende Tabelle enthält Beispiele für die zu verwendende Syntax zum Verweisen auf mehrwertige Parameter beliebigen Datentyps in einem Ausdruck.The following table shows examples of the syntax to use when you include a reference to a multivalue parameter of any data type in an expression.

BeispielExample BESCHREIBUNGDescription
=Parameters! <MultivalueParameterName> .IsMultiValue=Parameters! <MultivalueParameterName> .IsMultiValue Gibt True oder Falsezurück.Returns True or False.

Überprüft, ob ein Parameter mehrwertig ist.Checks if a parameter is multivalue. Wenn Truezurückgegeben wird, ist der Parameter mehrwertig und stellt eine Auflistung von Objekten dar.If True, the parameter is multivalue and is a collection of objects. Wenn FALSEzurückgegeben wird, ist der Parameter einwertig und stellt ein einzelnes Objekt dar.If False, the parameter is single-valued and is a single object.
=Parameters! <MultivalueParameterName> .Count=Parameters! <MultivalueParameterName> .Count Gibt eine ganze Zahl zurück.Returns an integer value.

Bezieht sich auf die Anzahl der Werte.Refers to the number of values. Für einwertige Parameter ist der Wert stets 1.For a single-value parameter, the count is always 1. Für mehrwertige Parameter ist der Wert 0 oder höher.For a multivalue parameter, the count is 0 or more.
=Parameters! <MultivalueParameterName> .Value(0)=Parameters! <MultivalueParameterName> .Value(0) Gibt den ersten Wert eines mehrwertigen Parameters zurück.Returns the first value in a multivalue parameter.
=Parameters! <MultivalueParameterName> .Value(Parameters! <MultivalueParameterName> .Count-1)=Parameters! <MultivalueParameterName> .Value(Parameters! <MultivalueParameterName> .Count-1) Gibt den letzten Wert eines mehrwertigen Parameters zurück.Returns the last value in a multivalue parameter.
=Split("Value1,Value2,Value3",",") Gibt ein Array von Werten zurück.Returns an array of values.

Erstellt ein Array von Werten für einen mehrwertigen String -Parameter.Create an array of values for a multivalue String parameter. Sie können ein beliebiges Trennzeichen im zweiten Parameter von Split verwenden.You can use any delimiter in the second parameter to Split. 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.This expression can be used to set defaults for a multivalue parameter or to create a multivalue parameter to send to a subreport or drillthrough report.
=Join(Parameters! <MultivalueParameterName> .Value,", ")=Join(Parameters! <MultivalueParameterName> .Value,", ") Gibt eine Zeichenfolge zurück, die eine Liste von durch Trennzeichen getrennten Werten in einem mehrwertigen Parameter enthält.Returns a String that consists of a comma-delimited list of values in a multivalue parameter. Sie können ein beliebiges Trennzeichen im zweiten Parameter von Join verwenden.You can use any delimiter in the second parameter to Join.

Weitere Informationen zum Verwenden von Parametern in einem Filter finden Sie unter Berichtsparameter (Berichts-Generator und Berichts-Designer).For more information about using parameters in a filter, see Report Parameters (Report Builder and Report Designer).

Weitere InformationenSee Also

Ausdrücke (Berichts-Generator und SSRS) Expressions (Report Builder and SSRS)
Häufig verwendete Filter (Berichts-Generator und SSRS) Commonly Used Filters (Report Builder and SSRS)
Hinzufügen, Ändern oder Löschen von Berichtsparametern (Berichts-Generator und SSRS) Add, Change, or Delete a Report Parameter (Report Builder and SSRS)
Tutorial: Add a Parameter to Your Report (Report Builder) (Tutorial: Hinzufügen eines Parameters zu einem Bericht (Berichts-Generator)) Tutorial: Add a Parameter to Your Report (Report Builder)
Lernprogramme für den Berichts-Generator Report Builder Tutorials
Integrierte Sammlungen in Ausdrücken (Berichts-Generator und SSRS)Built-in Collections in Expressions (Report Builder and SSRS)