Utilisation de références à la collection Parameters (Générateur de rapports version 3.0 et SSRS)
Les paramètres de rapport font partie des collections intégrées que vous pouvez référencer à partir d'une 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. Il est possible d'utiliser des expressions pour toute propriété de zone de texte ou d'élément de rapport qui intègre l'option (Fx) ou <Expression>. Les expressions sont également utilisées pour contrôler différemment le contenu et l'apparence d'un rapport. Pour plus d'informations, consultez Exemples d'expressions (Report Builder 3.0 et 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. 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. 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. Pour plus d'informations, consultez Utilisation des types de données dans les expressions (Générateur de rapports version 3.0 et 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.
Notes
Vous pouvez créer et modifier des définitions de rapports (.rdl) dans le Générateur de rapports version 3.0 et dans le Concepteur de rapports, dans Business Intelligence Development Studio. Chaque environnement de création offre différentes possibilités pour créer, ouvrir et enregistrer des rapports et des éléments connexes. Pour plus d'informations, consultez Conception de rapports dans le Concepteur de rapports et le Générateur de rapports version 3.0 (SSRS) sur le site Web Microsoft.
Utilisation d'un paramètre à valeur unique dans une 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.
Exemple |
Description |
|---|---|
=Parameters!<ParameterName>.IsMultiValue |
Retourne False. Vérifie si un paramètre est à valeurs multiples. Si la valeur retournée est True, le paramètre est à valeurs multiples et il s'agit d'une collection d'objets. Si la valeur retournée est False, le paramètre est à valeur unique et il s'agit d'un seul objet. |
=Parameters!<ParameterName>.Count |
Retourne la valeur entière 1. Pour un paramètre à valeur unique, le compte est toujours 1. |
=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. |
=Parameters!<ParameterName>.Value |
Retourne la valeur du paramètre. Si la propriété Label n'a pas été définie, cette valeur apparaît dans la liste déroulante des valeurs disponibles. |
=CStr(Parameters! <ParameterName>.Value) |
Retourne la valeur du paramètre sous forme de chaîne. |
=Fields(Parameters!<ParameterName>.Value).Value |
Retourne la valeur du champ qui possède le même nom que le paramètre. |
Pour plus d'informations sur l'utilisation de paramètres dans un filtre, consultez Ajout des filtres de datasets, des filtres de régions de données et des filtres de groupes (Générateur de rapports version 3.0 et SSRS).
Utilisation d'un paramètre à valeurs multiples dans une 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.
Exemple |
Description |
|---|---|
=Parameters!<MultivalueParameterName>.IsMultiValue |
Retourne True ou False. Vérifie si un paramètre est à valeurs multiples. Si la valeur retournée est True, le paramètre est à valeurs multiples et il s'agit d'une collection d'objets. Si la valeur retournée est False, le paramètre est à valeur unique et il s'agit d'un seul objet. |
=Parameters!<MultivalueParameterName>.Count |
Retourne une valeur entière. Fait référence au nombre de valeurs. Pour un paramètre à valeur unique, le compte est toujours 1. Pour un paramètre à valeurs multiples, le compte est 0 ou plus. |
=Parameters!<MultivalueParameterName>.Value(0) |
Retourne la première valeur dans un paramètre à valeurs multiples. |
=Parameters!<MultivalueParameterName>.Value(Parameters!<MultivalueParameterName>.Count-1) |
Retourne la dernière valeur dans un paramètre à valeurs multiples. |
=Split("Value1,Value2,Value3",",") |
Retourne un tableau de valeurs. Permet de créer un tableau de valeurs pour un paramètre de type String à valeurs multiples. Vous pouvez utiliser un délimiteur dans le second paramètre pour établir un fractionnement (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. |
=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. Vous pouvez utiliser un délimiteur dans le second paramètre pour établir une liaison (Join). |
Pour plus d'informations sur l'utilisation de paramètres dans un filtre, consultez Paramètres (Générateur de rapports version 3.0 et SSRS).
Voir aussi