TechNet
Exporter (0) Imprimer
Développer tout

Références à la collection Parameters (Générateur de rapports et SSRS)

 

S'applique à: SQL Server 2016

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. 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. 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’Expression & #40 ; SSRS & #41 ; et le Générateur de rapports.

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 la page Types de données dans les Expressions & #40 ; SSRS & #41 ; et le Générateur de rapports.

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.

System_CAPS_ICON_note.jpg Remarque


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. Chaque environnement de création offre différentes possibilités pour créer, ouvrir et enregistrer des rapports et des éléments connexes.

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.

ExempleDescription
=Parameters! < ParameterName> .IsMultiValueRetourne False.

Vérifie si un paramètre est à valeurs multiples. Si True, le paramètre est à valeurs multiples et il est une collection d’objets. Si False, le paramètre est à valeur unique et est un objet unique.
=Parameters! < ParameterName> .CountRetourne la valeur entière 1. Pour un paramètre à valeur unique, le nombre est toujours 1.
=Parameters! < ParameterName> .LabelRetourne l'étiquette du paramètre, qui est souvent utilisée comme nom complet dans une liste déroulante de valeurs disponibles.
=Parameters! < ParameterName> .ValueRetourne la valeur du paramètre. Si la propriété étiquette n’a pas été définie, cette valeur s’affiche dans la liste déroulante de valeurs disponibles.
=CStr(Parameters!  < ParameterName> .Value)Retourne la valeur du paramètre sous forme de chaîne.
=Fields(Parameters! < ParameterName> .Value).ValueRetourne 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 Ajouter des filtres de Dataset, filtres de régions de données et les filtres de groupe & #40 ; SSRS & #41 ; et le Générateur de rapports.

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.

ExempleDescription
=Parameters! < MultivalueParameterName> .IsMultiValueRetourne True ou False.

Vérifie si un paramètre est à valeurs multiples. Si True, le paramètre est à valeurs multiples et est une collection d’objets. Si False, le paramètre est une valeur unique et est un objet unique.
=Parameters! < MultivalueParameterName> .CountRetourne une valeur entière.

Fait référence au nombre de valeurs. Pour un paramètre à valeur unique, le nombre est toujours 1. Pour un paramètre à valeurs multiples, le nombre 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.

Créer un tableau de valeurs pour un à valeurs multiples chaîne paramètre. 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 un chaîne qui se compose d’une liste délimitée par des virgules des valeurs de 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 la page les paramètres de rapport & #40 ; Le Générateur de rapports et le Concepteur de rapports & #41 ;.

Expressions & #40 ; Le Générateur de rapports et SSRS & #41 ;
Filtres couramment utilisés & #40 ; Le Générateur de rapports et SSRS & #41 ;
Ajouter, modifier ou supprimer un paramètre de rapport & #40 ; Le Générateur de rapports et SSRS & #41 ;
Didacticiel : Ajouter un paramètre à votre rapport & #40 ; Le Générateur de rapports & #41 ;
Didacticiels du Générateur de rapports
Collections intégrées dans les Expressions & #40 ; Le Générateur de rapports et SSRS & #41 ;

Ajouts de la communauté

AJOUTER
Afficher:
© 2016 Microsoft