Utilizzo di raccolte predefinite nelle espressioni (Generatore report 3.0 e SSRS)
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. 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 ulteriori informazioni, vedere Espressioni (Generatore report 3.0 e SSRS).
Nota
È possibile creare e modificare definizioni del report (con estensione rdl) in Generatore report 3.0 e in Progettazione report di Business Intelligence Development Studio. Ogni ambiente di creazione offre modalità differenti per creare, aprire e salvare report ed elementi correlati. Per ulteriori informazioni, vedere Progettazione di report tramite Progettazione report e Generatore report 3.0 (SSRS) nel Web all'indirizzo microsoft.com.
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 |
|---|---|---|---|
Globals |
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 ulteriori informazioni, vedere Utilizzo di riferimenti a elementi globali e utenti predefiniti (Generatore report 3.0 e SSRS). |
User |
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 ulteriori informazioni, vedere Utilizzo di riferimenti a elementi globali e utenti predefiniti (Generatore report 3.0 e SSRS). |
Parameters |
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 ulteriori informazioni, vedere Utilizzo di riferimenti alla raccolta dei parametri (Generatore report 3.0 e SSRS). |
Fields(<Dataset>) |
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 ulteriori informazioni, vedere Utilizzo di riferimenti alla raccolta di campi del set di dati (Generatore report 3.0 e SSRS). |
DataSets |
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 ulteriori informazioni, vedere Utilizzo di riferimenti a raccolte DataSources e DataSets (Generatore report 3.0 e SSRS). |
DataSources |
Non visualizzata |
=DataSources("AdventureWorks").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 ulteriori informazioni, vedere Utilizzo di riferimenti a raccolte DataSources e DataSets (Generatore report 3.0 e SSRS). |
Variables |
Variables |
=Variables!CustomTimeStamp.Value |
Rappresenta la raccolta di variabili del report e variabili di gruppo. Per ulteriori informazioni, vedere Utilizzo di riferimenti a raccolte di variabili di report e di gruppo (Generatore report 3.0 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 ulteriori informazioni, vedere Utilizzo di riferimenti alla raccolta ReportItems (Generatore report 3.0 e SSRS). |
Utilizzo della sintassi delle raccolte in un'espressione
Per fare riferimento a una raccolta in un'espressione, utilizzare 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 |
Passaggio di raccolte predefinite negli assembly personalizzati
Per passare raccolte predefinite in un assembly personalizzato per l'elaborazione, è necessario aggiungere nel progetto di codice un riferimento all'assembly che definisce le raccolte predefinite e accedere allo spazio dei nomi corretto. A seconda che sia in corso lo sviluppo di un assembly personalizzato per un report eseguito in un server di report (report di server) o un report eseguito in modalità locale in un'applicazione .NET (report locale), cambia l'assembly a cui è necessario fare riferimento. Per informazioni dettagliate, vedere di seguito.
Spazio dei nomi: Microsoft.ReportingServices.ReportProcessing.ReportObjectModel
Assembly (report locale): Microsoft.ReportingServices.ProcessingObjectModel.dll
Assembly (report di server): Microsoft.ReportViewer.ProcessingObjectModel.dll
Poiché il contenuto delle raccolte Fields e ReportItems può cambiare in modo dinamico durante la fase di esecuzione, non trattenerle tra le chiamate nell'assembly personalizzato, ad esempio in una variabile membro. Lo stesso consiglio si applica in genere a tutte le raccolte predefinite.
Vedere anche