Riferimenti alla raccolta ReportItems in un report impaginato (Generatore di report)

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

La raccolta predefinita ReportItems è il set di caselle di testo di elementi del report, ad esempio righe di un'area dati o caselle di testo nell'area di progettazione del report impaginato. La raccolta ReportItems include caselle di testo che si trovano nell'ambito corrente di un'intestazione di pagina, un piè di pagina o il corpo di un report. Questa raccolta viene determinata in fase di esecuzione dal componente Elaborazione report e dal renderer di report. L'ambito corrente cambia quando il componente Elaborazione report combina in successione i dati del report e gli elementi di layout dei relativi elementi mentre l'utente visualizza le pagine di un report. È possibile usare la raccolta predefinita ReportItems per produrre intestazioni di pagina in formato dizionario in cui vengono visualizzati il primo e l'ultimo elemento in ogni pagina.

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.

Utilizzo della proprietà Value di ReportItems

Per gli elementi nella raccolta ReportItems è disponibile solo la proprietà Value. È possibile usare il valore per un elemento di ReportItems per visualizzare o calcolare i dati di un altro campo del report. Per accedere al valore della casella di testo corrente, è possibile usare la proprietà globale predefinita Me.Value di Visual Basic o semplicemente Value. Nelle funzioni per i report come First e nelle funzioni di aggregazione utilizzare la sintassi completa.

Ad esempio:

  • Questa espressione, se inserita in una casella di testo, visualizza il valore di una casella di testo ReportItem denominata Textbox1:

    =ReportItems!Textbox1.Value

  • Questa espressione, se inserita nella proprietà Color di una casella di testo ReportItem, visualizza il testo in nero quando il valore è > 0 e in rosso in tutti gli altri casi:

    =IIF(Me.Value > 0,"Black","Red")

  • Questa espressione, se inserita in una casella di testo nell'intestazione o nel piè di pagina, visualizza il primo valore per ogni pagina del report visualizzabile, per una casella di testo denominata LastName:

    =First(ReportItems("LastName").Value)

Espressioni per intestazioni di pagina in formato dizionario

È possibile creare un'intestazione di pagina in modo da visualizzare il primo e l'ultimo cliente nella pagina. Poiché una casella di testo nell'intestazione di pagina può fare riferimento alla raccolta predefinita ReportItems una sola volta in un'espressione, è necessario aggiungere due caselle di testo all'intestazione di pagina: una per il nome del primo cliente (=First(ReportItems!textboxLastName.Value) e l'altra per il nome dell'ultimo cliente (=Last(ReportItems!textboxLastName.Value).

In una sezione di intestazione o piè di pagina sono disponibili solo le caselle di testo della pagina corrente come membri della raccolta ReportItems . Ad esempio, se ReportItems!textboxLastName.Value fa riferimento a una casella di testo riportata solo nella prima pagina di un'area dati a più pagine, viene visualizzato un valore per la prima pagina, mentre per tutte le altre pagine viene visualizzato #Errore a indicare che l'espressione non può essere valutata come scritta.

Ambito per la raccolta ReportItems

Quando il report viene elaborato, ogni casella di testo nel corpo del report o in un'area dati viene valutata nel contesto del relativo set di dati, area dati e associazioni di gruppo. L'ambito per un riferimento alla raccolta ReportItems corrisponde all'ambito corrente o a qualsiasi punto superiore.

Ad esempio, una casella di testo in una riga appartenente a un gruppo padre non deve contenere un'espressione che fa riferimento al nome di una casella di testo in una riga di un gruppo figlio. Tale espressione non restituisce un valore nel report, perché la casella di testo nella riga figlio si trova al di fuori dell'ambito. Per altre informazioni, vedere Riferimento a funzioni di aggregazione (Generatore di report).