Utilizzo delle espressioni nei report (Generatore report e SSRS)Expression Uses in Reports (Report Builder and SSRS)

Nei report impaginati di Reporting ServicesReporting Services le espressioni sono usate nella definizione del report per specificare o calcolare valori per parametri, query, filtri, proprietà degli elementi del report, definizioni di gruppo e di ordinamento, proprietà delle caselle di testo, segnalibri, mappe documento, contenuto dinamico dell'intestazione e del piè di pagina, immagini e definizioni delle origini dati dinamiche.In Reporting ServicesReporting Services paginated reports, expressions are used throughout the report definition to specify or calculate values for parameters, queries, filters, report item properties, group and sort definitions, text box properties, bookmarks, document maps, dynamic page header and footer content, images, and dynamic data source definitions. In questo argomento vengono forniti esempi delle numerose posizioni in cui è possibile utilizzare le espressioni per modificare il contenuto o l'aspetto di un report.This topic provides examples of the many places you can use expressions to vary the content or appearance of a report. Non si tratta tuttavia di un elenco completo.This list is not comprehensive. È possibile impostare un'espressione per qualsiasi proprietà in una finestra di dialogo che viene visualizzata l'espressione (fx) pulsante o in un elenco a discesa che visualizza <Expression... >.You can set an expression for any property in a dialog box that displays the expression (fx) button or in a drop-down list that displays <Expression...>.

Le espressioni possono essere semplici o complesse.Expressions can be simple or complex. Leespressioni semplici contengono un riferimento a un solo campo del set di dati, un solo parametro o un solo campo predefinito.Simple expressions contain a reference to a single dataset field, parameter, or built-in field. Le espressioni complesse possono contenere più riferimenti incorporati, operatori e chiamate di funzione.Complex expressions can contain multiple built-in references, operators, and function calls. Ad esempio, un'espressione complessa potrebbe includere la funzione Sum applicata al campo Sales.For example, a complex expression might include the Sum function applied to the Sales field.

Le espressioni sono scritte in MicrosoftMicrosoft Visual BasicVisual Basic.Expressions are written in MicrosoftMicrosoft Visual BasicVisual Basic. Un'espressione inizia con un segno di uguale (=) seguito da una combinazione di riferimenti a raccolte predefinite, quali parametri e campi di set di dati, costanti, funzioni e operatori.An expression begins with an equal sign (=) followed by a combination of references to built-in collections such as dataset fields and parameters, constants, functions, and operators.

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 di espressioni semplici Using Simple Expressions

e vengono visualizzate tra parentesi nell'area di progettazione e nelle finestre di dialogo. Un campo del set di dati viene ad esempio visualizzato come [ProductID].Simple expressions appear on the design surface and in dialog boxes in brackets, for example, a dataset field appears as [ProductID]. Le espressioni semplici vengono create automaticamente quando si trascina un campo da un set di dati in una casella di testo.Simple expressions are created for you automatically when you drag a field from a dataset onto a text box. Viene creato un segnaposto e l'espressione definisce il valore sottostante.A placeholder is created and the expression defines the underlying value. È inoltre possibile digitare le espressioni direttamente in una cella o in una casella di testo dell'area dati, sia nell'area di progettazione che in una finestra di dialogo, ad esempio [ProductID].You can also type expressions directly into a data region cell or text box, both on the design surface or in a dialog box, (for example, [ProductID]).

Nella tabella seguente sono elencati esempi delle modalità di utilizzo delle espressioni semplici.The following table lists examples of the ways you can use simple expressions. Viene fornita la descrizione della funzionalità, della proprietà da impostare, della finestra di dialogo in genere utilizzata per l'impostazione e del valore per la proprietà.The table describes the functionality, the property to set, the dialog box you typically use to set it, and the value for the property. È possibile digitare l'espressione semplice direttamente nell'area di progettazione, in una finestra di dialogo o nel riquadro Proprietà oppure modificarla nella finestra di dialogo Espressione, procedendo come per qualsiasi espressione.You can type the simple expression directly on the design surface, in a dialog box, or in the Properties pane, or you can edit it in the Expression dialog box, just as you would with any expression.

FunzionalitàFunctionality Proprietà, contesto e finestra di dialogoProperty, Context, and Dialog Box Valore proprietàProperty Value
Specificare un campo del set di dati da visualizzare in una casella di testo.Specify a dataset field to display in a text box. Proprietà Value per un segnaposto in una casella di testo.Value property for a placeholder inside a text box. Usare la finestra di dialogo Proprietà segnaposto, Generale.Use Placeholder Properties Dialog Box, General. [Sales]
Aggregare valori per un gruppo.Aggregate values for a group. Proprietà Value per un segnaposto in una riga associata a un gruppo Tablix.Value property for a placeholder inside a row associated with a tablix group. Usare la finestra di dialogo Proprietà casella di testo.Use Textbox Properties Dialog Box. [Sum(Sales)]
Includere un numero di pagina.Include a page number. Proprietà Value per un segnaposto in una casella di testo posizionata in un'intestazione di pagina.Value property for a placeholder inside a text box that is placed in a page header. Usare la finestra di dialogo Proprietà casella di testo, Generale.Use Textbox Properties Dialog Box, General. [&PageNumber]
Visualizzare un valore di parametro selezionato.Display a selected parameter value. Proprietà Value per un segnaposto in una casella di testo nell'area di progettazione.Value property for a placeholder inside a text box on the design surface. Usare la finestra di dialogo Proprietà casella di testo, Generale.Use Textbox Properties Dialog Box, General. [@SalesThreshold]
Specificare una definizione di gruppo per un'area dati.Specify a group definition for a data region. Espressione di raggruppamento nel gruppo Tablix.Group expression on the tablix group. Usare la finestra di dialogo Proprietà gruppo Tablix, Generale.Use Tablix Group Properties Dialog Box, General. [Category]
Escludere un valore di campo specifico da una tabella.Exclude a specific field value from a table. Equazione di filtro nella Tablix.Filter equation on the tablix. Usare la finestra di dialogo Proprietà Tablix, Filtri.Use Tablix Properties Dialog Box, Filters. Come tipo di dati selezionare Integer.For data type, select Integer.

[Quantity]

>

100
Includere solo un valore specifico per un filtro di gruppo.Include only a specific value for a group filter. Equazione di filtro nel gruppo Tablix.Filter equation on the tablix group. Usare la finestra di dialogo Proprietà gruppo Tablix, Filtri.Use Tablix Group Properties Dialog Box, Filters. [Category]

=

Clothing
Escludere valori specifici per più campi da un set di dati.Exclude specific values for more than one field from a dataset. Equazione di filtro per un gruppo in una Tablix.Filter equation for a group in a tablix. Usare la finestra di dialogo Proprietà Tablix, Filtri.Use Tablix Properties Dialog Box, Filters. =[Color]

<>

Red

=[Color]

<>

Blue
Specificare l'ordinamento in base a un campo esistente in una tabella.Specify sort order based on an existing field in a table. Espressione di ordinamento nella Tablix.Sort expression on the tablix. Usare la finestra di dialogo Proprietà Tablix, Ordinamento.Use Tablix Properties Dialog Box, Sorting. [SizeSortOrder]
Collegare un parametro di query a un parametro di report.Link a query parameter to a report parameter. Raccolta di parametri nel set di dati.Parameters collection on the dataset. Usare la finestra di dialogo Proprietà set di dati, Parametri.Use Dataset Properties Dialog Box, Parameters. [@Category]

[@Category]
Passare un parametro da un report principale a un sottoreport.Pass a parameter from a main report to a subreport. Raccolta di parametri nel sottoreport.Parameters collection on the subreport. Usare la finestra di dialogo Proprietà sottoreport, Parametri.Use Subreport Properties Dialog Box, Parameters. [@Category]

[@Category]

Utilizzo di espressioni complesse Using Complex Expressions

Le espressioni complesse possono contenere più riferimenti, operatori e chiamate di funzione predefiniti e vengono visualizzate nell'area di progettazione come <<Expr>>.Complex expressions can contain multiple built-in references, operators, and function calls, and appear on the design surface as <<Expr>>. Per visualizzare o modificare il testo dell'espressione, è necessario aprire la finestra di dialogo Espressione o digitare direttamente nel riquadro Proprietà.To see or change the expression text, you must open the Expression dialog box or type directly in the Properties pane. Nella tabella seguente sono elencate le modalità di utilizzo standard di un'espressione complessa per visualizzare o organizzare i dati oppure modificare l'aspetto del report. Vengono ad esempio fornite indicazioni sulla proprietà da impostare, sulla finestra di dialogo in genere usata per l'impostazione e sul valore per la proprietà.The following table lists typical ways you can use a complex expression to display or organize data or change report appearance, including the property to set, the dialog box you typically use to set it, and the value for the property. È possibile digitare un'espressione direttamente in una finestra di dialogo, nell'area di progettazione o nel riquadro Proprietà.You can type an expression directly into a dialog box, on the design surface, or in the Properties pane.

FunzionalitàFunctionality Proprietà, contesto e finestra di dialogoProperty, Context, and Dialog Box Valore proprietàProperty Value
Calcolare i valori di aggregazione per un set di dati.Calculate aggregate values for a dataset. Proprietà Value per un segnaposto in una casella di testo.Value property for a placeholder inside of a text box. Usare la finestra di dialogo Proprietà segnaposto, Generale.Use Placeholder Properties Dialog Box, General. =First(Fields!Sales.Value,"DataSet1")
Concatenare testo ed espressioni nella stessa casella di testo.Concatenate text and expressions in the same text box. Value per un segnaposto in una casella di testo posizionata in un'intestazione o in un piè di pagina.Value for a placeholder inside of a text box that is placed in a page header or page footer. Usare la finestra di dialogo Proprietà segnaposto, Generale.Use Placeholder Properties Dialog Box, General. ="This report began processing at " & Globals!ExecutionTime
Calcolare un valore di aggregazione per un set di dati in un ambito diverso.Calculate an aggregate value for a dataset in a different scope. Value per un segnaposto in una casella di testo posizionata in un gruppo Tablix.Value for a placeholder inside of a text box that is placed in a tablix group. Usare la finestra di dialogo Proprietà segnaposto, Generale.Use Placeholder Properties Dialog Box, General. =Max(Fields!Total.Value,"DataSet2)
Formattare i dati in una casella di testo in base al valore.Format data in a text box depending on value. Colore per un segnaposto in una casella di testo nella riga dei dettagli di una Tablix.Color for a placeholder inside of a text box in the details row for a tablix. Usare la finestra di dialogo Proprietà casella di testo, Carattere.Use Text Box Properties Dialog Box, Font. =IIF(Fields!TotalDue.Value < 10000,"Red","Black")
Calcolare un valore una volta per farvi riferimento in tutto il report.Calculate a value once to refer to throughout the report. Value per una variabile del report.Value for a report variable. Usare la finestra di dialogo Proprietà report, Variabili.Use Report Properties Dialog Box, Variables. =Variables!MyCalculation.Value
Includere valori specifici per più campi di un set di dati.Include specific values for more than one field from a dataset. Equazione di filtro per un gruppo in una Tablix.Filter equation for a group in a tablix. Usare la finestra di dialogo Proprietà Tablix, Filtri.Use Tablix Properties Dialog Box, Filters. Come tipo di dati selezionare Boolean.For data type, select Boolean.

=IIF(InStr(Fields!Subcat.Value,"Shorts")=0 AND (Fields!Size.Value="M" OR Fields!Size.Value="S"),TRUE, FALSE)

=

TRUE
Nascondere una casella di testo nell'area di progettazione, la cui visibilità può essere attivata o disattivata dall'utente mediante un parametro booleano denominato Show.Hide a text box on the design surface, that can be toggled by the user using a Boolean parameter named Show. Hiddenproperty in una casella di testo.Hiddenproperty on a text box. Usare la finestra di dialogo Proprietà casella di testo, Visibilità.Use Text Box Properties Dialog Box, Visibility. =Not Parameters!Mostra<parametro booleano >.Value=Not Parameters! Show<boolean parameter> .Value
Specificare il contenuto dinamico dell'intestazione o del piè di pagina.Specify dynamic page header or footer content. Value per un segnaposto in una casella di testo posizionata nell'intestazione o nel piè di pagina.Value for a placeholder inside of a text box that is placed in the page header or footer. ="Page " & Globals!PageNumber & " of " & Globals!TotalPages
Specificare un'origine dati in modo dinamico utilizzando un parametro.Specify a data source dynamically by using a parameter. Stringa di connessione nell'origine dati.Connection string on the Data source. Usare la finestra di dialogo Proprietà origine dati, Generale.Use Data Source Properties Dialog Box, General. ="Data Source=" & Parameters!ServerName.Value & ";initial catalog=AdventureWorks2012"
Identificare tutti i valori per un parametro multivalore scelto dall'utente.Identify all the values for a multivalue parameter chosen by the user. Value per un segnaposto in una casella di testo.Value for a placeholder inside of a text box. Usare la finestra di dialogo Proprietà Tablix, Filtri.Use Tablix Properties Dialog Box, Filters. =Join(Parameters!MyMultivalueParameter.Value,", ")
Specificare interruzioni di pagina ogni 20 righe in una Tablix senza altri gruppi.Specify page breaks for every 20 rows in a tablix with no other groups. Espressione di raggruppamento per un gruppo in una Tablix.Group expression for a group in a tablix. Usare la finestra di dialogo Proprietà gruppo Tablix, Interruzioni di pagina.Use Group Properties Dialog Box, Page Breaks. Selezionare l'opzione Tra ogni istanza di un gruppo.Select the option Between each instance of a group. =Ceiling(RowNumber(Nothing)/20)
Specificare la visibilità condizionale in base a un parametro.Specify conditional visibility based on a parameter. Proprietà Hidden per una Tablix.Hidden property for a tablix. Usare la finestra di dialogo Proprietà Tablix, Visibilità.Use Tablix Properties Dialog Box, Visibility. =Not Parameters!< parametro booleano >.Value=Not Parameters!< boolean parameter >.Value
Specificare una data formattata per determinate impostazioni cultura.Specify a date formatted for a specific culture. Value per un segnaposto di una casella di testo in un'area dati.Value for a placeholder inside of a text box in a data region. Usare la finestra di dialogo Proprietà casella di testo, Generale.Use Textbox Properties Dialog Box, General. =Fields!OrderDate.Value.ToString(System.Globalization.CultureInfo.CreateSpecificCulture("de-DE"))
Concatenare una stringa e un numero nel formato di percentuale a due cifre decimali.Concatenate a string and a number formatted as a percentage to two decimal places. Value per un segnaposto di una casella di testo in un'area dati.Value for a placeholder inside of a text box in a data region. Usare la finestra di dialogo Proprietà casella di testo, Generale.Use Textbox Properties Dialog Box, General. ="Growth Percent: " & Format(Fields!Growth.Value,"p2")

Vedere ancheSee Also

Espressioni ( Generatore report e SSRS ) Expressions (Report Builder and SSRS)
Esempi di espressioni ( Generatore report e SSRS ) Expression Examples (Report Builder and SSRS)
I parametri di report ( Generatore report e progettazione Report ) Report Parameters (Report Builder and Report Designer)
Esempi di equazioni di filtro ( Generatore report e SSRS ) Filter Equation Examples (Report Builder and SSRS)
Filtro, gruppo e ordinamento dei dati ( Generatore report e SSRS ) Filter, Group, and Sort Data (Report Builder and SSRS)
Le intestazioni di pagina e piè di pagina ( Generatore report e SSRS ) Page Headers and Footers (Report Builder and SSRS)
Formattazione di testo e segnaposto ( Generatore report e SSRS ) Formatting Text and Placeholders (Report Builder and SSRS)
Nascondere un elemento ( Generatore report e SSRS )Hide an Item (Report Builder and SSRS)