Raccolte predefinite nelle espressioni in un report impaginato (Generatore report)

Si applica a:✅ Generatore di report Microsoft (SSRS) ✅ Power BI Report Builder ✅ Report Designer in SQL Server Data Tools

In un'espressione di un report impaginato è 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. Nella finestra di dialogo Espressione non vengono visualizzate tutte le raccolte. Le raccolte DataSets e DataSources sono disponibili solo in fase di progettazione per i report pubblicati in un server di report. 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.

Per altre informazioni, vedere Espressioni (Generatore report e SSRS).

Nota

È possibile creare e modificare file di definizioni di report impaginati (con estensione rdl) in Generatore report di Microsoft, Power BI Report Builder e Progettazione report di SQL Server Data Tools.

Informazioni sulle raccolte predefinite

Nella tabella seguente sono elencate le raccolte predefinite disponibili quando si scrive un'espressione. 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.

Raccolta predefinita	Categoria nella finestra di dialogo Espressione	Esempio	Descrizione
Elementi globali	Campi predefiniti	=Globals.ReportName - or - =Globals.PageNumber	Rappresenta le variabili globali utili per i report, quali il nome del report o il numero di pagina. Sempre disponibile. Per altre informazioni, vedere Riferimenti alle raccolte predefinite Globals e Users (Generatore report e SSRS).
Utente	Campi predefiniti	=User.UserID - oppure - =User.Language	Rappresenta una raccolta di dati relativi all'utente che esegue il report, ad esempio l'impostazione della lingua o l'ID utente. Sempre disponibile. Per altre informazioni, vedere Riferimenti alle raccolte predefinite Globals e Users (Generatore report e SSRS).
Parametri	Parametri	=Parameters("ReportMonth").Value - oppure - =Parameters!ReportYear.Value	Rappresenta la raccolta dei parametri del report, che possono essere a valore singolo o multivalore. Non disponibile prima del completamento dell'inizializzazione dell'elaborazione. Per altre informazioni, vedere Riferimenti alla raccolta dei parametri (Generatore report e SSRS).
Campi(<Set di dati>)	Campi	=Fields!Sales.Value	Rappresenta la raccolta di campi del set di dati disponibili per il report. Disponibile dopo il recupero dei dati da un'origine dei dati in un set di dati. Per altre informazioni, vedere Riferimenti alla raccolta di campi del set di dati (Generatore report e SSRS).
Set di dati	Non visualizzata	=DataSets("TopEmployees").CommandText	Rappresenta la raccolta di set di dati a cui si fa riferimento nel corpo della definizione del report. Non include origini dei dati utilizzate solo nelle intestazioni pagina o nei piè di pagina. Non disponibile nell'anteprima locale. Per altre informazioni, vedere Riferimenti a raccolte DataSources e DataSets (Generatore report e SSRS).
DataSources	Non visualizzata	=DataSources("AdventureWorks2022").Type	Rappresenta la raccolta di origini dei dati a cui viene fatto riferimento nel corpo di un report. Non include origini dei dati utilizzate solo nelle intestazioni pagina o nei piè di pagina. Non disponibile nell'anteprima locale. Per altre informazioni, vedere Riferimenti a raccolte DataSources e DataSets (Generatore report e SSRS).
Variabili	Variables	=Variables!CustomTimeStamp.Value	Rappresenta la raccolta di variabili del report e variabili di gruppo. Per altre informazioni, vedere Riferimenti a raccolte di variabili di report e di gruppo (Generatore report e SSRS).
ReportItems	Non visualizzata	=ReportItems("Textbox1").Value	Rappresenta la raccolta di caselle di testo per un elemento del report. Questa raccolta può essere utilizzata per riepilogare gli elementi nella pagina da includere in un'intestazione o in un piè di pagina. Per altre informazioni, vedere Riferimenti alla raccolta ReportItems (Generatore report e SSRS).

Utilizzo della sintassi delle raccolte in un'espressione

Per fare riferimento a una raccolta in un'espressione, usare la sintassi standard di Microsoft Visual Basic per un elemento di una raccolta. Nella tabella seguente sono illustrati alcuni esempi di sintassi di raccolta.

Sintassi	Esempio
Collection!ObjectName.Property	=Fields!Sales.Value
Collection!ObjectName("Property")	=Fields!Sales("Value")
Collection("ObjectName").Property	=Fields("Sales").Value
Collection("Member")	=User("Language")
Collection.Member	=User.Language

Vedi anche

Aggiungere un'espressione (Generatore di report e SSRS)
Esempi di espressioni (Generatore di report e SSRS)