Raccolte predefinite nelle espressioni (Generatore Report)Built-in Collections in Expressions (Report Builder)

Nell'espressione di un report è possibile includere riferimenti alle raccolte predefinite seguenti: ReportItems, Parameters, Fields, DataSets, DataSources, Variables e a campi predefiniti per informazioni generali quali il nome del report.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. Nella finestra di dialogo Espressione non vengono visualizzate tutte le raccolte.Not all collections appear in the Expression dialog box. Le raccolte DataSets e DataSources sono disponibili solo in fase di progettazione per i report pubblicati in un server di report.The DataSets and DataSources collections are available only at run-time for published reports on a report server. ReportItems è una raccolta di caselle di testo in un'area del report, ad esempio le caselle di testo visualizzate in una pagina o in un'intestazione.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.

Per altre informazioni, vedere Espressioni (Generatore report e SSRS).For more information, see Expressions (Report Builder and SSRS).

Nota

È possibile creare e modificare file di definizioni report impaginati (con estensione rdl) in Generatore report e in Progettazione report di 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. Ogni ambiente di creazione offre modalità differenti per creare, aprire e salvare report ed elementi correlati.Each authoring environment provides different ways to create, open, and save reports and related items.

Informazioni sulle raccolte predefinite Understanding Built-in Collections

Nella tabella seguente sono elencate le raccolte predefinite disponibili quando si scrive un'espressione.The following table lists the built-in collections available when you write an expression. Ogni riga include il nome a livello di programmazione della raccolta, con distinzione tra maiuscole e minuscole, l'indicazione se è possibile utilizzare la finestra di dialogo Espressione per aggiungere un riferimento alla raccolta in modo interattivo, un esempio e una descrizione in cui è specificato quando vengono inizializzati i valori della raccolta e sono quindi disponibili per l'uso.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.

Raccolta predefinitaBuilt-in Collection Categoria nella finestra di dialogo EspressioneCategory in the Expression dialog box EsempioExample DescriptionDescription
Elementi globaliGlobals Campi predefinitiBuilt-in Fields =Globals.ReportName

- or -

=Globals.PageNumber
Rappresenta le variabili globali utili per i report, quali il nome del report o il numero di pagina.Represents global variables useful for reports, such as the report name or page number. Sempre disponibile.Always available.

Per altre informazioni, vedere Riferimenti alle raccolte predefinite Globals e User (Generatore report e SSRS).For more information, see Built-in Globals and Users References (Report Builder and SSRS).
UtenteUser Campi predefinitiBuilt-in Fields =User.UserID

- oppure -- or -

=User.Language
Rappresenta una raccolta di dati relativi all'utente che esegue il report, ad esempio l'impostazione della lingua o l'ID utente.Represents a collection of data about the user running the report, such as the language setting or the user ID. Sempre disponibile.Always available.

Per altre informazioni, vedere Riferimenti alle raccolte predefinite Globals e User (Generatore report e SSRS).For more information, see Built-in Globals and Users References (Report Builder and SSRS).
ParametriParameters ParametriParameters =Parameters("ReportMonth").Value

- oppure -- or -

=Parameters!ReportYear.Value
Rappresenta la raccolta dei parametri del report, che possono essere a valore singolo o multivalore.Represents the collection of report parameters, each of which can be single-value or multivalue. Non disponibile prima del completamento dell'inizializzazione dell'elaborazione.Not available until processing initialization is complete. Per altre informazioni, vedere Riferimenti alla raccolta dei parametri (Generatore report e SSRS).For more information, see Parameters Collection References (Report Builder and SSRS).
Campi ( <set di dati > )Fields( <Dataset> ) CampiFields =Fields!Sales.Value Rappresenta la raccolta di campi del set di dati disponibili per il report.Represents the collection of fields of the dataset that are available to the report. Disponibile dopo il recupero dei dati da un'origine dei dati in un set di dati.Available after data is retrieved from a data source into a dataset. Per altre informazioni, vedere Riferimenti alla raccolta di campi del set di dati (Generatore report e SSRS).For more information, see Dataset Fields Collection References (Report Builder and SSRS).
DataSetsDataSets Non visualizzataNot Displayed =DataSets("TopEmployees").CommandText Rappresenta la raccolta di set di dati a cui si fa riferimento nel corpo della definizione del report.Represents the collection of datasets referenced from the body of a report definition. Non include origini dei dati utilizzate solo nelle intestazioni pagina o nei piè di pagina.Does not include data sources used only in page headers or page footers. Non disponibile nell'anteprima locale.Not available in local preview. Per altre informazioni, vedere Riferimenti a raccolte DataSources e DataSets (Generatore report e SSRS).For more information, see DataSources and DataSets Collection References (Report Builder and SSRS).
DataSourcesDataSources Non visualizzataNot Displayed =DataSources("AdventureWorks2012").Type Rappresenta la raccolta di origini dei dati a cui viene fatto riferimento nel corpo di un report.Represents the collection of data sources referenced from within the body of a report. Non include origini dei dati utilizzate solo nelle intestazioni pagina o nei piè di pagina.Does not include data sources used only in page headers or page footers. Non disponibile nell'anteprima locale.Not available in local preview. Per altre informazioni, vedere Riferimenti a raccolte DataSources e DataSets (Generatore report e SSRS).For more information, see DataSources and DataSets Collection References (Report Builder and SSRS).
VariabiliVariables Variables =Variables!CustomTimeStamp.Value Rappresenta la raccolta di variabili del report e variabili di gruppo.Represents the collection of report variables and group variables. Per altre informazioni, vedere Riferimenti a raccolte di variabili di report e di gruppo (Generatore report e SSRS).For more information, see Report and Group Variables Collections References (Report Builder and SSRS).
ReportItemsReportItems Non visualizzataNot Displayed =ReportItems("Textbox1").Value Rappresenta la raccolta di caselle di testo per un elemento del report.Represents the collection of text boxes for a report item. Questa raccolta può essere utilizzata per riepilogare gli elementi nella pagina da includere in un'intestazione o in un piè di pagina.This collection can be used to summarize items on the page for including in a page header or page footer. Per altre informazioni, vedere Riferimenti alla raccolta ReportItems (Generatore report e SSRS).For more information, see ReportItems Collection References (Report Builder and SSRS).

Utilizzo della sintassi delle raccolte in un'espressione Using Collection Syntax in an Expression

Per fare riferimento a una raccolta in un'espressione, utilizzare la sintassi standard di MicrosoftMicrosoft Visual BasicVisual Basic per un elemento di una raccolta.To refer to a collection from an expression, use standard MicrosoftMicrosoft Visual BasicVisual Basic syntax for an item in a collection. Nella tabella seguente sono illustrati alcuni esempi di sintassi di raccolta.The following table shows examples of collection syntax.

SintassiSyntax EsempioExample
Collection!ObjectName.PropertyCollection!ObjectName.Property =Fields!Sales.Value
Collection!ObjectName("Property")Collection!ObjectName("Property") =Fields!Sales("Value")
Collection("ObjectName").PropertyCollection("ObjectName").Property =Fields("Sales").Value
Collection("Member")Collection("Member") =User("Language")
Collection.MemberCollection.Member =User.Language

Vedere ancheSee Also

Aggiungere un'espressione ( Generatore report e SSRS ) Add an Expression (Report Builder and SSRS)
Esempi di espressioni ( Generatore report e SSRS )Expression Examples (Report Builder and SSRS)