Collections intégrées dans les Expressions (Générateur de rapports)Built-in Collections in Expressions (Report Builder)

Dans une expression d'un rapport, vous avez la possibilité d'inclure des références aux collections intégrées suivantes : ReportItems, Parameters, Fields, DataSets, DataSources, Variables, ainsi que des champs prédéfinis pour les informations globales telles que le nom du rapport.In an expression in a report, you can include references to the following built-in collections: ReportItems, Parameters, Fields, DataSets, DataSources, Variables, and built-in fields for global information such as the report name. Les collections ne sont pas toutes répertoriées dans la boîte de dialogue Expression .Not all collections appear in the Expression dialog box. En effet, les collections DataSets et DataSources ne sont disponibles qu'au moment de l'exécution pour les rapports publiés sur un serveur de rapports.The DataSets and DataSources collections are available only at run-time for published reports on a report server. La collection ReportItems représente l'ensemble des zones de texte figurant dans une partie du rapport, comme celles qui sont situées dans une page ou dans un en-tête de page.The ReportItems collection is collection of text boxes in a report region, for example, the text boxes on a page or in a page header.

Pour plus d’informations, consultez Expressions (Générateur de rapports et SSRS).For more information, see Expressions (Report Builder and SSRS).

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.

Fonctionnement des collections intégrées Understanding Built-in Collections

Le tableau suivant répertorie les collections intégrées disponibles lorsque vous écrivez une expression.The following table lists the built-in collections available when you write an expression. Chaque ligne inclut le nom de programmation, sensible à la casse, de la collection, indique si vous pouvez utiliser la boîte de dialogue Expression pour ajouter une référence à la collection de manière interactive, propose un exemple et précise quand les valeurs de la collection sont initialisées et peuvent être utilisées.Each row includes the case-sensitive programmatic name for the collection, whether you can use the Expression dialog box to interactively add a reference to the collection, an example, and a description that includes when the collection values are initialized and available for use.

Collection intégréeBuilt-in Collection Catégorie dans la boîte de dialogue ExpressionCategory in the Expression dialog box ExempleExample DescriptionDescription
GlobalsGlobals Champs prédéfinisBuilt-in Fields =Globals.ReportName

- or -

=Globals.PageNumber
Représente les variables globales utilisables pour des rapports, par exemple le nom du rapport ou le numéro de page.Represents global variables useful for reports, such as the report name or page number. Toujours disponible.Always available.

Pour plus d’informations, consultez Références à des champs Globals et Users prédéfinis (Générateur de rapports et SSRS).For more information, see Built-in Globals and Users References (Report Builder and SSRS).
UtilisateurUser Champs prédéfinisBuilt-in Fields =User.UserID

- ou -- or -

=User.Language
Représente une collection de données sur l'utilisateur exécutant le rapport, par exemple le paramètre de langue ou l'ID utilisateur.Represents a collection of data about the user running the report, such as the language setting or the user ID. Toujours disponible.Always available.

Pour plus d’informations, consultez Références à des champs Globals et Users prédéfinis (Générateur de rapports et SSRS).For more information, see Built-in Globals and Users References (Report Builder and SSRS).
ParamètresParameters ParametersParameters =Parameters("ReportMonth").Value

- ou -- or -

=Parameters!ReportYear.Value
Représente la collection des paramètres de rapport, chacun pouvant correspondre à une valeur unique ou à plusieurs valeurs.Represents the collection of report parameters, each of which can be single-value or multivalue. Non disponible tant que l'initialisation du traitement n'est pas terminée.Not available until processing initialization is complete. Pour plus d’informations, consultez Informations de référence sur la collection de paramètres (Générateur de rapports et SSRS).For more information, see Parameters Collection References (Report Builder and SSRS).
Fields( <Dataset> )Fields( <Dataset> ) ChampsFields =Fields!Sales.Value Représente la collection des champs du dataset qui sont disponibles pour le rapport.Represents the collection of fields of the dataset that are available to the report. Disponibles après extraction des données d'une source de données dans un dataset.Available after data is retrieved from a data source into a dataset. Pour plus d’informations, consultez Références à une collection de champs de dataset (Générateur de rapports et SSRS).For more information, see Dataset Fields Collection References (Report Builder and SSRS).
DataSetsDataSets Non affichéeNot Displayed =DataSets("TopEmployees").CommandText Représente la collection de sources de données référencées à partir du corps d'une définition de rapport.Represents the collection of datasets referenced from the body of a report definition. N'inclut pas les sources de données utilisées uniquement dans les en-têtes ou les pieds de page.Does not include data sources used only in page headers or page footers. Non disponible dans l'aperçu local.Not available in local preview. Pour plus d’informations, consultez Références à des collections DataSources et DataSets (Générateur de rapports et SSRS).For more information, see DataSources and DataSets Collection References (Report Builder and SSRS).
DataSourcesDataSources Non affichéeNot Displayed =DataSources("AdventureWorks2012").Type Représente la collection des sources de données référencées à partir du corps d'un rapport.Represents the collection of data sources referenced from within the body of a report. N'inclut pas les sources de données utilisées uniquement dans les en-têtes ou les pieds de page.Does not include data sources used only in page headers or page footers. Non disponible dans l'aperçu local.Not available in local preview. Pour plus d’informations, consultez Références à des collections DataSources et DataSets (Générateur de rapports et SSRS).For more information, see DataSources and DataSets Collection References (Report Builder and SSRS).
VariablesVariables Variables =Variables!CustomTimeStamp.Value Représente la collection des variables de rapport et de groupe.Represents the collection of report variables and group variables. Pour plus d’informations, consultez Références à des collections de variables de rapport et de groupe (Générateur de rapports et SSRS).For more information, see Report and Group Variables Collections References (Report Builder and SSRS).
ReportItemsReportItems Non affichéeNot Displayed =ReportItems("Textbox1").Value Représente la collection des zones de texte d'un élément de rapport.Represents the collection of text boxes for a report item. Cette collection peut être utilisée pour proposer un résumé des éléments présents dans la page en vue de leur inclusion dans un en-tête ou un pied de page.This collection can be used to summarize items on the page for including in a page header or page footer. Pour plus d’informations, consultez Références à la collection ReportItems (Générateur de rapports et SSRS).For more information, see ReportItems Collection References (Report Builder and SSRS).

Utilisation de la syntaxe de collection dans une expression Using Collection Syntax in an Expression

Pour faire référence à une collection à partir d’une expression, utilisez la syntaxe MicrosoftMicrosoft Visual BasicVisual Basic standard pour un élément au sein d’une collection.To refer to a collection from an expression, use standard MicrosoftMicrosoft Visual BasicVisual Basic syntax for an item in a collection. Le tableau ci-après propose des exemples de syntaxe de collection.The following table shows examples of collection syntax.

SyntaxeSyntax ExempleExample
Collection!NomObjet.PropriétéCollection!ObjectName.Property =Fields!Sales.Value
Collection!NomObjet("Propriété")Collection!ObjectName("Property") =Fields!Sales("Value")
Collection("NomObjet").PropriétéCollection("ObjectName").Property =Fields("Sales").Value
Collection("Membre")Collection("Member") =User("Language")
Collection.MembreCollection.Member =User.Language

Voir aussiSee Also

Ajouter une expression (Générateur de rapports et SSRS) Add an Expression (Report Builder and SSRS)
Exemples d’expressions (Générateur de rapports et SSRS) Expression Examples (Report Builder and SSRS)