Raccolte predefinite - riferimenti alla raccolta ReportItems (Generatore Report)Built-in Collections - ReportItems Collection References (Report Builder)

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.The ReportItems built-in collection is the set of text boxes from report items such as rows of a data region or text boxes on the report design surface. 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.The ReportItems collection includes text boxes that are in the current scope of a page header, page footer, or report body. Questa raccolta viene determinata in fase di esecuzione dal componente Elaborazione report e dal renderer di report.This collection is determined at run time by the report processor and the report renderer. 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.The current scope changes as the report processor successively combines report data and the report item layout elements as the user views pages of a 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.You can use the ReportItems built-in collection to produce dictionary-style page headers that show the first and last items on each page.

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.

Utilizzo della proprietà Valute di ReportItemsUsing the ReportItems Value Property

Per gli elementi nella raccolta ReportItems è disponibile solo la proprietà Value.Items within the ReportItems collection have only one property: Value. È possibile usare il valore per un elemento di ReportItems per visualizzare o calcolare i dati di un altro campo del report.The value for a ReportItems item can be used to display or calculate data from another field in the report. Per accedere al valore della casella di testo corrente, è possibile usare la proprietà globale predefinita Me.Value di Visual BasicVisual Basic o semplicemente Value.To access the value of the current text box, you can use the Visual BasicVisual Basic built-in global Me.Value or simply Value. Nelle funzioni per i report come First e nelle funzioni di aggregazione utilizzare la sintassi completa.In report functions such as First and aggregate functions, use the fully qualified syntax.

Esempio:For example:

  • Questa espressione, se inserita in una casella di testo, visualizza il valore di una casella di testo ReportItem denominata Textbox1:This expression, placed in a text box, displays the value of a ReportItem text box named Textbox1:

    =ReportItems!Textbox1.Value

  • Questa espressione, inserita un ReportItem proprietà Color, casella di testo viene visualizzato il testo in nero quando il valore è > 0; in caso contrario, il valore viene visualizzato in rosso:This expression, placed in a ReportItem text box Color property, displays the text in black when the value is > 0; otherwise, the value is displayed in red:

    =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:This expression, placed in a text box in the page header or page footer, displays the first value per page of the rendered report, for a text box named LastName:

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

Espressioni per intestazioni di pagina in formato dizionarioDictionary-Style Page Header Expressions

È possibile creare un'intestazione di pagina in modo da visualizzare il primo e l'ultimo cliente nella pagina.You can create a page header to display the first customer on the page and the last customer on the page. 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).Because a text box in the page header can only refer to the ReportItems built-in collection once in an expression, you need to add two text boxes to the page header: one for the first customer name (=First(ReportItems!textboxLastName.Value) and one for the last customer name (=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 .In a page header or page footer section, only text boxes on the current page are available as a member of the ReportItems collection. 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.For example, if ReportItems!textboxLastName.Value refers to a text box that only appears on the first page for a multipage data region, you see a value for the first page, but all other pages display #Error to show the expression could not be evaluated as written.

Ambito per la raccolta ReportItemsScope for the ReportItems Collection

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.As the report is processed, each text box in the report body or in a data region is evaluated in the context of its dataset, data region, and group associations. L'ambito per un riferimento alla raccolta ReportItems corrisponde all'ambito corrente o a qualsiasi punto superiore.The scope for a reference to the ReportItems collection is the current scope or any point higher than the current scope.

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.For example, a text box in a row that is in a parent group must not contain an expression that refers to the name of a text box in a child group row. Tale espressione non restituisce un valore nel report, perché la casella di testo nella riga figlio si trova al di fuori dell'ambito.Such an expression does not resolve to a value in the report because the child row text box is out of scope. Per altre informazioni, vedere Riferimento a funzioni di aggregazione (Generatore report e SSRS).For more information, see Aggregate Functions Reference (Report Builder and SSRS).

Vedere ancheSee Also

Raccolte predefinite nelle espressioni ( Generatore report e SSRS ) Built-in Collections in Expressions (Report Builder and SSRS)
Esempi di espressioni ( Generatore report e SSRS ) Expression Examples (Report Builder and SSRS)
Paginazione in Reporting Services ( Generatore report e SSRS ) Pagination in Reporting Services (Report Builder and SSRS)
Filtro, gruppo e ordinamento dei dati ( Generatore report e SSRS )Filter, Group, and Sort Data (Report Builder and SSRS)