Utilisation de paramètres dans les expressions

Nouveau : 17 juillet 2006

Cette rubrique contient plusieurs exemples de la syntaxe dans laquelle vous devez inclure des références à des paramètres de rapport dans une expression. Les paramètres de rapport font partie des collections globales que vous pouvez référencer à partir d'une expression. Pour plus d'informations, consultez Utilisation de collections globales dans les expressions (Reporting Services).

Les paramètres sont évalués lorsqu'un rapport est traité. Il est possible d'utiliser des expressions partout dans une propriété de zone de texte ou d'élément de rapport qui intègre l'option (Fx) ou <Expression>. Pour obtenir des exemples indiquant où les expressions peuvent être utilisées, consultez Exemples d'expressions dans Reporting Services.

Les types des paramètres de rapport sont les suivants : booléen, date/heure, entier, Float ou chaîne. Les paramètres de rapport peuvent être à valeurs multiples ou à valeur unique. Vous pouvez définir la propriété à valeurs multiples pour tous les types de paramètres, à l'exception des types booléens. Un paramètre à valeurs multiples est un tableau de valeurs de base zéro. Pour plus d'informations sur la définition des propriétés de rapport, consultez Création de paramètres de rapport et définition des propriétés des paramètres de rapport.

Paramètres à une seule valeur

Le tableau suivant inclut des exemples d'utilisation d'un paramètre à une seule valeur dans une expression.

Utilisation d'un paramètre à une seule valeur dans une expression

Le tableau suivant présente des exemples de la syntaxe à utiliser lorsque vous incluez une référence à un paramètre à une seule valeur 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, la valeur 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 de 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.

Définition d'un filtre à l'aide d'un paramètre à une seule valeur

Les filtres sont définis à l'aide de l'onglet Filtre des pages de propriétés des datasets, des régions de données ou des regroupements de données. Vous définissez l'expression de filtre en entrant des valeurs dans la grille de filtrage de l'onglet Filtre. Le tableau suivant représente la grille de filtrage. L'exemple suivant part du principe que les valeurs de Fields!EmployeeID.Value et Parameters!EmployeeID.Value sont du même type de données.

Expression (de filtre)	Opérateur	Valeur	Et/ou
= Fields!<FieldName>.Value	Tout opérateur qui compare une valeur à une autre. Par exemple : = >= <	=Parameters!<ParameterName>.Value	Valeur prédéfinie qui est activée lorsque vous entrez plusieurs expressions.

Paramètres à valeurs multiples

Le tableau suivant inclut des exemples d'utilisation d'un paramètre à valeurs multiples dans une expression.

Utilisation d'un paramètre à valeurs multiples dans une expression

Il est possible d'utiliser des expressions partout dans une propriété de zone de texte ou d'élément de rapport qui intègre l'option (Fx) ou <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 à une seule valeur, 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. Permet de créer un tableau de valeurs pour un paramètre de type Chaîne à 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 chaîne 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).

Définition d'un filtre à l'aide d'un paramètre à valeurs multiples

Les filtres sont définis à l'aide de l'onglet Filtre des pages de propriétés des datasets, des régions de données ou des regroupements de données. L'exemple suivant part du principe que les valeurs de Fields!EmployeeID.Value et Parameters!EmployeeID.Value sont du même type de données. Les paramètres à valeurs multiples peuvent uniquement apparaître dans la colonne Valeur.

Expression	Opérateur	Valeur	Et/ou
= Fields!<FieldName>.Value	Opérateur qui teste l'inclusion de groupes. Le seul choix disponible est : IN	=Parameters!<MultivalueParameterName>.Value	Valeur prédéfinie qui est définie lorsque vous entrez plusieurs expressions.

Exemples de référencement de paramètres à partir de code personnalisé

Vous pouvez référencer la collection globale de paramètres via du code personnalisé dans un bloc de code de la définition de rapport ou dans un assembly personnalisé que vous fournissez. La collection de paramètres est en lecture seule et ne possède aucun itérateur public. Vous ne pouvez pas utiliser une construction For Each Visual Basic pour parcourir la collection. Vous devez connaître le nom d'un paramètre défini dans une définition de rapport pour pouvoir ensuite le référencer dans votre code. Cependant, vous pouvez effectuer une itération dans toutes les valeurs d'un paramètre à valeurs multiples. Pour plus d'informations, consultez Utilisation de références de code personnalisé dans des expressions (Reporting Services).

Description	Référence dans une expression	Définition de code personnalisé
Transmission de l'intégralité de la collection globale de paramètres au code personnalisé. Cette fonction retourne la valeur d'un paramètre de rapport spécifique MyParameter.	=Code.DisplayAParameterValue(Parameters)	Public Function DisplayAParameterValue( ByVal parameters as Parameters) as Object Return parameters("MyParameter").Value End Function
Transmission d'un seul paramètre au code personnalisé. Cet exemple retourne la valeur du paramètre transmis. Si le paramètre est un paramètre à valeurs multiples, la chaîne retournée est une concaténation de toutes les valeurs.	=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

Voir aussi

Tâches

Procédure : ajouter, modifier ou supprimer un paramètre de rapport (Concepteur de rapports)

Référence

Exemples d'expressions dans Reporting Services

Concepts

Utilisation de paramètres à valeur unique et à valeurs multiples

Autres ressources

Using Custom Assemblies with Reports
Didacticiel : Ajout de paramètres à un rapport tabulaire de base
Didacticiel : Fonctionnalités avancées utilisant les paramètres

Aide et Informations

Assistance sur SQL Server 2005