Utilisation d'expressions dans les rapports (Générateur de rapport et SSRS)Expression Uses in Reports (Report Builder and SSRS)

Dans les rapports paginés Reporting ServicesReporting Services , les expressions sont utilisées dans la définition des rapports pour spécifier ou calculer les valeurs des paramètres, requêtes, filtres, propriétés d’éléments de rapport, définitions de groupe et de tri, propriétés de zone de texte, signets, explorateurs de documents, contenu d’en-tête et de pied de page dynamique, images et définitions de source de données dynamiques.In Reporting ServicesReporting Services paginated reports, expressions are used throughout the report definition to specify or calculate values for parameters, queries, filters, report item properties, group and sort definitions, text box properties, bookmarks, document maps, dynamic page header and footer content, images, and dynamic data source definitions. Cette rubrique fournit des exemples des nombreux emplacements où vous pouvez utiliser des expressions pour varier le contenu ou l'apparence d'un rapport.This topic provides examples of the many places you can use expressions to vary the content or appearance of a report. Cette liste n'est pas exhaustive.This list is not comprehensive. Vous pouvez définir une expression pour toute propriété dans une boîte de dialogue qui affiche le bouton d’expression (fx) ou dans une liste déroulante qui affiche <Expression...>.You can set an expression for any property in a dialog box that displays the expression (fx) button or in a drop-down list that displays <Expression...>.

Les expressions peuvent être simples ou complexes.Expressions can be simple or complex. Lesexpressions simples contiennent une référence à un champ de dataset, paramètre ou champ intégré unique.Simple expressions contain a reference to a single dataset field, parameter, or built-in field. Les expressions complexes peuvent contenir plusieurs références intégrées, opérateurs et appels de fonction.Complex expressions can contain multiple built-in references, operators, and function calls. Par exemple, une expression complexe peut inclure la fonction Sum appliquée au champ Sales.For example, a complex expression might include the Sum function applied to the Sales field.

Les expressions sont écrites en MicrosoftMicrosoft Visual BasicVisual Basic.Expressions are written in MicrosoftMicrosoft Visual BasicVisual Basic. Une expression commence par un signe égal (=) suivi d'une combinaison de références à des collections intégrées, telles que des paramètres et champs de dataset, constantes, fonctions et opérateurs.An expression begins with an equal sign (=) followed by a combination of references to built-in collections such as dataset fields and parameters, constants, functions, and operators.

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'expressions simplesUsing Simple Expressions

Les expressions simples apparaissent entre crochets sur l'aire de conception et dans les boîtes de dialogue ; par exemple, un champ de dataset apparaît comme [ProductID].Simple expressions appear on the design surface and in dialog boxes in brackets, for example, a dataset field appears as [ProductID]. Elles sont créées automatiquement lorsque vous faites glisser un champ d'un dataset vers une zone de texte.Simple expressions are created for you automatically when you drag a field from a dataset onto a text box. Un espace réservé est créé et l'expression définit la valeur sous-jacente.A placeholder is created and the expression defines the underlying value. Vous pouvez également taper les expressions directement dans une cellule de région de données ou zone de texte sur l'aire de conception ou dans une boîte de dialogue (par exemple, [ProductID]).You can also type expressions directly into a data region cell or text box, both on the design surface or in a dialog box, (for example, [ProductID]).

Le tableau suivant répertorie des exemples d'utilisations des expressions simples.The following table lists examples of the ways you can use simple expressions. Le tableau décrit la fonctionnalité, la propriété à définir, la boîte de dialogue utilisée en général pour la définir et la valeur de la propriété.The table describes the functionality, the property to set, the dialog box you typically use to set it, and the value for the property. Vous pouvez taper l'expression simple directement sur l'aire de conception, dans une boîte de dialogue ou dans le volet Propriétés, ou vous pouvez la modifier dans la boîte de dialogue Expression, comme vous le feriez avec toute expression.You can type the simple expression directly on the design surface, in a dialog box, or in the Properties pane, or you can edit it in the Expression dialog box, just as you would with any expression.

FonctionnalitéFunctionality Propriété, contexte et boîte de dialogueProperty, Context, and Dialog Box Valeur de propriétéProperty Value
Spécifier un champ de dataset à afficher dans une zone de texte.Specify a dataset field to display in a text box. Propriété Value d’un espace réservé à l’intérieur d’une zone de texte.Value property for a placeholder inside a text box. Utilisez la boîte de dialogue Propriétés de l'espace réservé, Général.Use Placeholder Properties Dialog Box, General. [Sales]
Agréger des valeurs pour un groupe.Aggregate values for a group. Propriété Value d’un espace réservé à l’intérieur d’une ligne associée à un groupe de tableaux matriciels.Value property for a placeholder inside a row associated with a tablix group. Utilisez la boîte de dialogue Propriétés de la zone de texte.Use Textbox Properties Dialog Box. [Sum(Sales)]
Inclure un numéro de page.Include a page number. Propriété Value d’un espace réservé à l’intérieur d’une zone de texte placée dans un en-tête de page.Value property for a placeholder inside a text box that is placed in a page header. Utilisez la boîte de dialogue Propriétés de la zone de texte, Général.Use Textbox Properties Dialog Box, General. [&PageNumber]
Afficher une valeur de paramètre sélectionnée.Display a selected parameter value. Propriété Value d’un espace réservé à l’intérieur d’une zone de texte dans l’aire de conception.Value property for a placeholder inside a text box on the design surface. Utilisez la boîte de dialogue Propriétés de la zone de texte, Général.Use Textbox Properties Dialog Box, General. [@SalesThreshold]
Spécifier une définition de groupe pour une région de données.Specify a group definition for a data region. Expression de groupe sur le groupe de tableaux matriciels.Group expression on the tablix group. Utilisez la boîte de dialogue Propriétés du groupe de tableaux matriciels, Général.Use Tablix Group Properties Dialog Box, General. [Category]
Exclure une valeur de champ spécifique d'une table.Exclude a specific field value from a table. Équation de filtre sur le tableau matriciel.Filter equation on the tablix. Utilisez la boîte de dialogue Propriétés du tableau matriciel, Filtres.Use Tablix Properties Dialog Box, Filters. Pour le type de données, sélectionnez Entier.For data type, select Integer.

[Quantity]

>

100
Inclure uniquement une valeur spécifique pour un filtre de groupe.Include only a specific value for a group filter. Équation de filtre sur le groupe de tableaux matriciels.Filter equation on the tablix group. Utilisez la boîte de dialogue Propriétés du groupe de tableaux matriciels, Filtres.Use Tablix Group Properties Dialog Box, Filters. [Category]

=

Clothing
Exclure des valeurs spécifiques pour plusieurs champs d'un dataset.Exclude specific values for more than one field from a dataset. Équation de filtre pour un groupe dans un tableau matriciel.Filter equation for a group in a tablix. Utilisez la boîte de dialogue Propriétés du tableau matriciel, Filtres.Use Tablix Properties Dialog Box, Filters. =[Color]

<>

Red

=[Color]

<>

Blue
Spécifier l'ordre de tri selon un champ existant dans une table.Specify sort order based on an existing field in a table. Expression de tri sur le tableau matriciel.Sort expression on the tablix. Utilisez la boîte de dialogue Propriétés du tableau matriciel, Tri.Use Tablix Properties Dialog Box, Sorting. [SizeSortOrder]
Lier un paramètre de requête à un paramètre de rapport.Link a query parameter to a report parameter. Collection de paramètres sur le dataset.Parameters collection on the dataset. Utilisez la boîte de dialogue Propriétés du dataset, Paramètres.Use Dataset Properties Dialog Box, Parameters. [@Category]

[@Category]
Transmettre un paramètre d'un rapport principal à un sous-rapport.Pass a parameter from a main report to a subreport. Collection de paramètres sur le sous-rapport.Parameters collection on the subreport. Utilisez la boîte de dialogue Propriétés du sous-rapport, Paramètres.Use Subreport Properties Dialog Box, Parameters. [@Category]

[@Category]

Utilisation d'expressions complexesUsing Complex Expressions

Les expressions complexes peuvent contenir plusieurs références intégrées, opérateurs et appels de fonction, et apparaissent dans l’aire de conception sous la forme <<Expr>>.Complex expressions can contain multiple built-in references, operators, and function calls, and appear on the design surface as <<Expr>>. Pour voir ou modifier le texte de l'expression, vous devez ouvrir la boîte de dialogue Expression ou taper directement dans le volet Propriétés.To see or change the expression text, you must open the Expression dialog box or type directly in the Properties pane. Le tableau suivant répertorie les utilisations classiques d'une expression complexe pour afficher ou organiser des données, ou modifier l'apparence du rapport, y compris la propriété à définir, la boîte de dialogue utilisée en général pour la définir et la valeur de la propriété.The following table lists typical ways you can use a complex expression to display or organize data or change report appearance, including the property to set, the dialog box you typically use to set it, and the value for the property. Vous pouvez taper une expression directement dans une boîte de dialogue, sur l'aire de conception ou dans le volet Propriétés.You can type an expression directly into a dialog box, on the design surface, or in the Properties pane.

FonctionnalitéFunctionality Propriété, contexte et boîte de dialogueProperty, Context, and Dialog Box Valeur de propriétéProperty Value
Calculer les valeurs d'agrégat pour un dataset.Calculate aggregate values for a dataset. Propriété Value d’un espace réservé à l’intérieur d’une zone de texte.Value property for a placeholder inside of a text box. Utilisez la boîte de dialogue Propriétés de l'espace réservé, Général.Use Placeholder Properties Dialog Box, General. =First(Fields!Sales.Value,"DataSet1")
Concaténer du texte et des expressions dans la même zone de texte.Concatenate text and expressions in the same text box. Propriété Value d’un espace réservé à l’intérieur d’une zone de texte placée dans un en-tête ou un pied de page.Value for a placeholder inside of a text box that is placed in a page header or page footer. Utilisez la boîte de dialogue Propriétés de l'espace réservé, Général.Use Placeholder Properties Dialog Box, General. ="This report began processing at " & Globals!ExecutionTime
Calculer une valeur d'agrégat pour un dataset dans une étendue différente.Calculate an aggregate value for a dataset in a different scope. Propriété Value d’un espace réservé à l’intérieur d’une zone de texte placée dans un groupe de tableaux matriciels.Value for a placeholder inside of a text box that is placed in a tablix group. Utilisez la boîte de dialogue Propriétés de l'espace réservé, Général.Use Placeholder Properties Dialog Box, General. =Max(Fields!Total.Value,"DataSet2)
Mettre en forme des données dans une zone de texte selon la valeur.Format data in a text box depending on value. Propriété Color d’un espace réservé à l’intérieur d’une zone de texte sur la ligne Détails d’un tableau matriciel.Color for a placeholder inside of a text box in the details row for a tablix. Utilisez la boîte de dialogue Propriétés de la zone de texte, Police.Use Text Box Properties Dialog Box, Font. =IIF(Fields!TotalDue.Value < 10000,"Red","Black")
Calculer une valeur une fois pour s'y reporter dans tout le rapport.Calculate a value once to refer to throughout the report. Propriété Value d’une variable de rapport.Value for a report variable. Utilisez la boîte de dialogue Propriétés du rapport, Variables.Use Report Properties Dialog Box, Variables. =Variables!MyCalculation.Value
Inclure des valeurs spécifiques pour plusieurs champs d'un dataset.Include specific values for more than one field from a dataset. Équation de filtre pour un groupe dans un tableau matriciel.Filter equation for a group in a tablix. Utilisez la boîte de dialogue Propriétés du tableau matriciel, Filtres.Use Tablix Properties Dialog Box, Filters. Pour le type de données, sélectionnez Booléen.For data type, select Boolean.

=IIF(InStr(Fields!Subcat.Value,"Shorts")=0 AND (Fields!Size.Value="M" OR Fields!Size.Value="S"),TRUE, FALSE)

=

TRUE
Masquer une zone de texte sur l'aire de conception, qui peut être activée ou désactivée par l'utilisateur à l'aide d'un paramètre booléen nommé Show.Hide a text box on the design surface, that can be toggled by the user using a Boolean parameter named Show. Propriété masquée dans une zone de texte.Hiddenproperty on a text box. Utilisez la boîte de dialogue Propriétés de la zone de texte, Visibilité.Use Text Box Properties Dialog Box, Visibility. =Not Parameters! Afficher<paramètre_booléen> .Value=Not Parameters! Show<boolean parameter> .Value
Spécifier un contenu dynamique de l'en-tête de page ou du pied de page.Specify dynamic page header or footer content. Valeur d’un espace réservé à l’intérieur d’une zone de texte placée dans l’en-tête ou le pied de page.Value for a placeholder inside of a text box that is placed in the page header or footer. ="Page " & Globals!PageNumber & " of " & Globals!TotalPages
Spécifier une source de données de façon dynamique à l'aide d'un paramètre.Specify a data source dynamically by using a parameter. Chaîne de connexion sur la source de données.Connection string on the Data source. Utilisez la boîte de dialogue Propriétés de la source de données, Général.Use Data Source Properties Dialog Box, General. ="Data Source=" & Parameters!ServerName.Value & ";initial catalog=AdventureWorks2012"
Identifier toutes les valeurs pour un paramètre à valeurs multiples choisi par l'utilisateur.Identify all the values for a multivalue parameter chosen by the user. Valeur d’un espace réservé à l’intérieur d’une zone de texte.Value for a placeholder inside of a text box. Utilisez la boîte de dialogue Propriétés du tableau matriciel, Filtres.Use Tablix Properties Dialog Box, Filters. =Join(Parameters!MyMultivalueParameter.Value,", ")
Spécifier des sauts de page toutes les 20 lignes dans un tableau matriciel sans aucun autre groupe.Specify page breaks for every 20 rows in a tablix with no other groups. Expression de groupe pour un groupe dans un tableau matriciel.Group expression for a group in a tablix. Utilisez la boîte de dialogue Propriétés du groupe de tableaux matriciels, Sauts de page.Use Group Properties Dialog Box, Page Breaks. Sélectionnez l'option Entre chaque instance d'un groupe.Select the option Between each instance of a group. =Ceiling(RowNumber(Nothing)/20)
Spécifier une visibilité conditionnelle basée sur un paramètre.Specify conditional visibility based on a parameter. Propriété masquée d’un tableau matriciel.Hidden property for a tablix. Utilisez la boîte de dialogue Propriétés du tableau matriciel, Visibilité.Use Tablix Properties Dialog Box, Visibility. =Not Parameters!< boolean parameter >.Value=Not Parameters!< boolean parameter >.Value
Spécifier une date mise en forme pour une culture spécifique.Specify a date formatted for a specific culture. Valeur d’un espace réservé à l’intérieur d’une zone de texte dans une région de données.Value for a placeholder inside of a text box in a data region. Utilisez la boîte de dialogue Propriétés de la zone de texte, Général.Use Textbox Properties Dialog Box, General. =Fields!OrderDate.Value.ToString(System.Globalization.CultureInfo.CreateSpecificCulture("de-DE"))
Concaténer une chaîne et un nombre mis en forme comme un pourcentage à deux décimales.Concatenate a string and a number formatted as a percentage to two decimal places. Valeur d’un espace réservé à l’intérieur d’une zone de texte dans une région de données.Value for a placeholder inside of a text box in a data region. Utilisez la boîte de dialogue Propriétés de la zone de texte, Général.Use Textbox Properties Dialog Box, General. ="Growth Percent: " & Format(Fields!Growth.Value,"p2")

Voir aussiSee Also

Expressions (Générateur de rapports et SSRS) Expressions (Report Builder and SSRS)
Exemples d’expressions (Générateur de rapports et SSRS) Expression Examples (Report Builder and SSRS)
Paramètres de rapport (Générateur de rapports et Concepteur de rapports) Report Parameters (Report Builder and Report Designer)
Exemples d’équations de filtre (Générateur de rapports et SSRS) Filter Equation Examples (Report Builder and SSRS)
Filtrer, regrouper et trier des données (Générateur de rapports et SSRS) Filter, Group, and Sort Data (Report Builder and SSRS)
En-têtes et pieds de page (Générateur de rapports et SSRS) Page Headers and Footers (Report Builder and SSRS)
Mise en forme du texte et des espaces réservés (Générateur de rapports et SSRS) Formatting Text and Placeholders (Report Builder and SSRS)
Masquer un élément (Générateur de rapports et SSRS)Hide an Item (Report Builder and SSRS)