• Articolo

Utilizzo di raccolte predefinite nelle espressioni (Reporting Services)

In Reporting Services sono disponibili le raccolte predefinite seguenti, a cui è possibile fare riferimento da un'espressione: ReportItems, Parameters, Fields, DataSets, DataSources, Variables e campi predefiniti per informazioni globali come 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 Informazioni sui riferimenti a espressioni (Reporting Services).

Informazioni sulle raccolte predefinite

Nella tabella seguente sono elencate le raccolte predefinite rese disponibili da Reporting Services. 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 campi predefiniti nelle espressioni (Reporting Services).

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 campi predefiniti nelle espressioni (Reporting Services).

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 Parameters nelle espressioni (Reporting Services).

Fields(<Dataset>)

Campi

=Fields!Sales.Value

Rappresenta l'insieme 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 nelle espressioni (Reporting Services).

DataSets

Non visualizzata

=DataSets("TopEmployees").CommandText

Rappresenta l'insieme 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 nelle espressioni (Reporting Services).

DataSources

Non visualizzata

=DataSources("AdventureWorks").Type

Rappresenta l'insieme 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 nelle espressioni (Reporting Services).

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 nelle espressioni (Reporting Services).

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 nelle espressioni (Reporting Services).

Utilizzo della sintassi delle raccolte in un'espressione

Per fare riferimento a una raccolta in un'espressione, utilizzare la sintassi standard di MicrosoftVisual 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