Collections intégrées - références à la Collection Parameters (Générateur de rapports)Built-in Collections - Parameters Collection References (Report Builder)

Les paramètres de rapport font partie des collections intégrées que vous pouvez référencer à partir d'une expression.Report parameters are one of the built-in collections you can reference from an expression. En incluant des paramètres dans une expression, vous pouvez personnaliser les données et l'apparence d'un rapport en fonction des choix faits par un utilisateur.By including parameters in an expression, you can customize report data and appearance based on choices a user makes. Expressions peuvent être utilisées pour toute propriété d’élément de rapport ou de la propriété de zone de texte qui fournit la (Fx) ou < Expression> option.Expressions can be used for any report item property or text box property that provides the (Fx) or <Expression> option. Les expressions sont également utilisées pour contrôler différemment le contenu et l'apparence d'un rapport.Expressions are also used to control report content and appearance in other ways. Pour plus d’informations, consultez Exemples d’expressions (Générateur de rapports et SSRS).For more information, see Expression Examples (Report Builder and SSRS).

Lorsque vous comparez des valeurs de paramètres à des valeurs de champs de dataset au moment de l'exécution, les types de données des deux éléments que vous comparez doivent être identiques.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. Les paramètres de rapport peuvent être de l'un des types suivants : Booléen, DateTime, Entier, Float ou Texte, qui représente le type de données sous-jacent Chaîne.Report parameters can be one of the following types: Boolean, DateTime, Integer, Float, or Text, which represents the underlying data type String. Si nécessaire, vous pouvez convertir le type de données de la valeur du paramètre pour qu'il corresponde à la valeur du dataset.If necessary, you might have to convert the data type of the parameter value to match the dataset value. Pour plus d’informations, consultez Types de données dans les expressions (Générateur de rapports et SSRS).For more information, see Data Types in Expressions (Report Builder and SSRS).

Pour inclure une référence de paramètre dans une expression, vous devez comprendre comment spécifier la syntaxe correcte pour la référence de paramètre, laquelle varie suivant que le paramètre est un paramètre à valeur unique ou à valeurs multiples.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.

Note

Vous pouvez créer et modifier des fichiers de définition de rapport (.rdl) paginés dans le Générateur de rapports et dans le Concepteur de rapports dans SQL Server Data Tools.You can create and modify paginated report definition (.rdl) files in Report Builder and in Report Designer in SQL Server Data Tools. Chaque environnement de création offre différentes possibilités pour créer, ouvrir et enregistrer des rapports et des éléments connexes.Each authoring environment provides different ways to create, open, and save reports and related items.

Utilisation d'un paramètre à valeur unique dans une expression Using a Single-Valued Parameter in an Expression

Le tableau suivant présente des exemples de la syntaxe à utiliser lorsque vous incluez une référence à un paramètre à valeur unique de n'importe quel type de données dans une expression.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.

ExempleExample DescriptionDescription
=Parameters!* <Nom_paramètre >.IsMultiValue=Parameters! *<ParameterName> .IsMultiValue Retourne False.Returns False.

Vérifie si un paramètre est à valeurs multiples.Checks if a parameter is multivalue. Si True, le paramètre est à valeurs multiples et il s’agit d’une collection d’objets.If True, the parameter is multivalue and it is a collection of objects. Si False, le paramètre est à valeur unique et il s’agit d’un seul objet.If False, the parameter is single-value and is a single object.
=Parameters!* <Nom_paramètre >.Count=Parameters! *<ParameterName> .Count Retourne la valeur entière 1.Returns the integer value 1. Pour un paramètre à valeur unique, le nombre est toujours 1.For a single-value parameter, the count is always 1.
=Parameters!* <Nom_paramètre >.Label=Parameters! *<ParameterName> .Label Retourne l'étiquette du paramètre, qui est souvent utilisée comme nom complet dans une liste déroulante de valeurs disponibles.Returns the parameter label, frequently used as the display name in a drop-down list of available values.
=Parameters!* <Nom_paramètre >.Value=Parameters! *<ParameterName> .Value Retourne la valeur du paramètre.Returns the parameter value. Si la propriété Libellé n’a pas été définie, cette valeur apparaît dans la liste déroulante des valeurs disponibles.If the Label property has not been set, this value appears in the drop-down list of available values.
=CStr(Parameters! <Nom_paramètre >.Value)=CStr(Parameters! <ParameterName> .Value) Retourne la valeur du paramètre sous forme de chaîne.Returns the parameter value as a string.
=Fields(Parameters!* <Nom_paramètre >.Value).Value=Fields(Parameters! *<ParameterName> .Value).Value Retourne la valeur du champ qui possède le même nom que le paramètre.Returns the value for the field that has the same name as the parameter.

Pour plus d’informations sur l’utilisation de paramètres dans un filtre, consultez Ajouter des filtres de datasets, des filtres de régions de données et des filtres de groupes (Générateur de rapports et SSRS).For more information about using parameters in a filter, see Add Dataset Filters, Data Region Filters, and Group Filters (Report Builder and SSRS).

Utilisation d'un paramètre à valeurs multiples dans une expression Using a Multivalue Parameter in an Expression

Le tableau suivant présente des exemples de la syntaxe à utiliser lorsque vous incluez une référence à un paramètre à valeurs multiples de n'importe quel type de données dans une expression.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.

ExempleExample DescriptionDescription
=Parameters!* <MultivalueParameterName >.IsMultiValue=Parameters! *<MultivalueParameterName> .IsMultiValue Retourne True ou False.Returns True or False.

Vérifie si un paramètre est à valeurs multiples.Checks if a parameter is multivalue. Si True, le paramètre est à valeurs multiples et il s’agit d’une collection d’objets.If True, the parameter is multivalue and is a collection of objects. Si False, le paramètre est à valeur unique et il s’agit d’un seul objet.If False, the parameter is single-valued and is a single object.
=Parameters!* <MultivalueParameterName >.Count=Parameters! *<MultivalueParameterName> .Count Retourne une valeur entière.Returns an integer value.

Fait référence au nombre de valeurs.Refers to the number of values. Pour un paramètre à valeur unique, le nombre est toujours 1.For a single-value parameter, the count is always 1. Pour un paramètre à valeurs multiples, le nombre est 0 ou plus.For a multivalue parameter, the count is 0 or more.
=Parameters!* <MultivalueParameterName >.Value(0)=Parameters! *<MultivalueParameterName> .Value(0) Retourne la première valeur dans un paramètre à valeurs multiples.Returns the first value in a multivalue parameter.
=Parameters!* <MultivalueParameterName >* .Value(Parameters! * <MultivalueParameterName >.Count-1)=Parameters! *<MultivalueParameterName> .Value(Parameters! <MultivalueParameterName> .Count-1) Retourne la dernière valeur dans un paramètre à valeurs multiples.Returns the last value in a multivalue parameter.
=Split("Value1,Value2,Value3",",") Retourne un tableau de valeurs.Returns an array of values.

Permet de créer un tableau de valeurs pour un paramètre de type String à valeurs multiples.Create an array of values for a multivalue String parameter. Vous pouvez utiliser un délimiteur dans le second paramètre pour établir un fractionnement (Split).You can use any delimiter in the second parameter to Split. Cette expression peut être utilisée pour définir les valeurs par défaut d'un paramètre à valeurs multiples ou pour créer un paramètre à valeurs multiples à envoyer à un rapport d'extraction ou de type sous-rapport.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,", ") Retourne une valeur de type String qui est composée d’une liste de valeurs délimitées par des virgules dans un paramètre à valeurs multiples.Returns a String that consists of a comma-delimited list of values in a multivalue parameter. Vous pouvez utiliser un délimiteur dans le second paramètre pour établir une liaison (Join).You can use any delimiter in the second parameter to Join.

Pour plus d’informations sur l’utilisation de paramètres dans un filtre, consultez Paramètres de rapport (Générateur de rapports et Concepteur de rapports).For more information about using parameters in a filter, see Report Parameters (Report Builder and Report Designer).

Voir aussiSee Also

Expressions (Générateur de rapports et SSRS) Expressions (Report Builder and SSRS)
Filtres couramment utilisés (Générateur de rapports et SSRS) Commonly Used Filters (Report Builder and SSRS)
Ajouter, modifier ou supprimer un paramètre de rapport (Générateur de rapports et SSRS) Add, Change, or Delete a Report Parameter (Report Builder and SSRS)
Didacticiel : Ajout d’un paramètre à un rapport (Générateur de rapports) Tutorial: Add a Parameter to Your Report (Report Builder)
Didacticiels du Générateur de rapports Report Builder Tutorials
Collections intégrées dans les expressions (Générateur de rapports et SSRS) Built-in Collections in Expressions (Report Builder and SSRS)