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

I parametri di un report sono una delle raccolte predefinite a cui è possibile fare riferimento da un'espressione.Report parameters are one of the built-in collections you can reference from an expression. Includendo parametri in un'espressione, è possibile personalizzare i dati e l'aspetto dei report in base alle opzioni scelte da un utente.By including parameters in an expression, you can customize report data and appearance based on choices a user makes. Le espressioni possono essere utilizzate per qualsiasi proprietà di elemento di report o una proprietà casella di testo che fornisce il (Fx) o < espressione> opzione.Expressions can be used for any report item property or text box property that provides the (Fx) or <Expression> option. Le espressioni vengono anche utilizzate per controllare il contenuto e l'aspetto dei report in altri modi.Expressions are also used to control report content and appearance in other ways. Per altre informazioni, vedere Esempi di espressioni (Generatore report e SSRS).For more information, see Expression Examples (Report Builder and SSRS).

Quando si confrontano i valori dei parametri con i valori dei campi di set di dati in fase di esecuzione, i tipi di dati per i due elementi confrontati devono essere identici.When you compare parameter values with dataset field values at run time, the data types for the two items you are comparing must be the same. I parametri dei report possono essere dei tipi seguenti: Boolean, DateTime, Integer, Float o Text, che rappresenta il tipo di dati stringa sottostante.Report parameters can be one of the following types: Boolean, DateTime, Integer, Float, or Text, which represents the underlying data type String. Può essere necessario convertire il tipo di dati del valore del parametro in base al valore del set di dati.If necessary, you might have to convert the data type of the parameter value to match the dataset value. Per altre informazioni, vedere Tipi di dati nelle espressioni (Generatore report e SSRS).For more information, see Data Types in Expressions (Report Builder and SSRS).

Per includere un riferimento a un parametro in un'espressione, è necessario essere in grado di specificare la sintassi corretta per tale riferimento, che varia a seconda che il parametro sia a valore singolo o multivalore.In order to include a parameter reference in an expression, you must understand how to specify the correct syntax for the parameter reference, which varies depending on whether the parameter is a single-value or multivalue parameter.

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 un parametro a valore singolo in un'espressione Using a Single-Valued Parameter in an Expression

Nella tabella seguente sono riportati esempi della sintassi da utilizzare quando si include in un'espressione un riferimento a un parametro a valore singolo di un tipo di dati qualsiasi.The following table shows examples of the syntax to use when you include a reference to a single-value parameter of any data type in an expression.

EsempioExample DescriptionDescription
=Parameters! <Nomeparametro >.IsMultiValue=Parameters! <ParameterName> .IsMultiValue Restituisce False.Returns False.

Verifica se un parametro è multivalore.Checks if a parameter is multivalue. Se è True, il parametro è multivalore ed è costituito da una raccolta di oggetti.If True, the parameter is multivalue and it is a collection of objects. Se è False, il parametro è a valore singolo ed è costituito da un solo oggetto.If False, the parameter is single-value and is a single object.
=Parameters! <Nomeparametro >.Count=Parameters! <ParameterName> .Count Restituisce il valore intero 1.Returns the integer value 1. Per un parametro a valore singolo, il conteggio è sempre 1.For a single-value parameter, the count is always 1.
=Parameters! <Nomeparametro >.Label=Parameters! <ParameterName> .Label Restituisce l'etichetta del parametro, utilizzata di frequente come nome visualizzato in un elenco a discesa di valori disponibili.Returns the parameter label, frequently used as the display name in a drop-down list of available values.
=Parameters! <Nomeparametro >.Value=Parameters! <ParameterName> .Value Restituisce il valore del parametro.Returns the parameter value. Se la proprietà Etichetta non è stata impostata, questo valore verrà visualizzato nell'elenco a discesa dei valori disponibili.If the Label property has not been set, this value appears in the drop-down list of available values.
=CStr(Parameters! <Nomeparametro >.Value)=CStr(Parameters! <ParameterName> .Value) Restituisce il valore del parametro sotto forma di stringa.Returns the parameter value as a string.
=Fields(Parameters! <Nomeparametro >.Value).Value=Fields(Parameters! <ParameterName> .Value).Value Restituisce il valore del campo il cui nome è uguale a quello del parametro.Returns the value for the field that has the same name as the parameter.

Per altre informazioni sull'uso dei parametri in un filtro, vedere Aggiungere filtri per set di dati, aree dati e gruppi (Generatore report e SSRS).For more information about using parameters in a filter, see Add Dataset Filters, Data Region Filters, and Group Filters (Report Builder and SSRS).

Utilizzo di un parametro multivalore in un'espressione Using a Multivalue Parameter in an Expression

Nella tabella seguente sono riportati esempi della sintassi da utilizzare quando si include in un'espressione un riferimento a un parametro multivalore di un tipo di dati qualsiasi.The following table shows examples of the syntax to use when you include a reference to a multivalue parameter of any data type in an expression.

EsempioExample DescriptionDescription
=Parameters! <MultivalueParameterName >.IsMultiValue=Parameters! <MultivalueParameterName> .IsMultiValue Restituisce True o False.Returns True or False.

Verifica se un parametro è multivalore.Checks if a parameter is multivalue. Se è True, il parametro è multivalore ed è costituito da una raccolta di oggetti.If True, the parameter is multivalue and is a collection of objects. Se è False, il parametro è a valore singolo ed è costituito da un solo oggetto.If False, the parameter is single-valued and is a single object.
=Parameters! <MultivalueParameterName >.Count=Parameters! <MultivalueParameterName> .Count Restituisce un valore intero.Returns an integer value.

Fa riferimento al numero di valori.Refers to the number of values. Per un parametro a valore singolo, il conteggio è sempre 1.For a single-value parameter, the count is always 1. Per un parametro multivalore, il conteggio è 0 o maggiore di zero.For a multivalue parameter, the count is 0 or more.
=Parameters! <MultivalueParameterName >.Value(0)=Parameters! <MultivalueParameterName> .Value(0) Restituisce il primo valore di un parametro multivalore.Returns the first value in a multivalue parameter.
=Parameters! <MultivalueParameterName > .Value(Parameters! <MultivalueParameterName >.Count-1)=Parameters! <MultivalueParameterName> .Value(Parameters! <MultivalueParameterName> .Count-1) Restituisce l'ultimo valore di un parametro multivalore.Returns the last value in a multivalue parameter.
=Split("Value1,Value2,Value3",",") Restituisce una matrice di valori.Returns an array of values.

Creare una matrice di valori per un parametro multivalore di tipo Stringa .Create an array of values for a multivalue String parameter. È possibile utilizzare qualsiasi delimitatore nel secondo parametro per dividere.You can use any delimiter in the second parameter to Split. È possibile utilizzare questa espressione per impostare i valori predefiniti di un parametro multivalore oppure creare un parametro multivalore da inviare a un sottoreport o a un report drill-through.This expression can be used to set defaults for a multivalue parameter or to create a multivalue parameter to send to a subreport or drillthrough report.
=Join(Parameters! <MultivalueParameterName >.Value,", ")=Join(Parameters! <MultivalueParameterName> .Value,", ") Restituisce un oggetto Stringa costituito da un elenco di valori delimitati da virgole in un parametro multivalore.Returns a String that consists of a comma-delimited list of values in a multivalue parameter. È possibile utilizzare qualsiasi delimitatore nel secondo parametro per unire.You can use any delimiter in the second parameter to Join.

Per ulteriori informazioni sull'utilizzo di parametri in un filtro, vedere i parametri di Report ( Generatore report e progettazione Report ) .For more information about using parameters in a filter, see Report Parameters (Report Builder and Report Designer).

Vedere ancheSee Also

Espressioni (Generatore report e SSRS) Expressions (Report Builder and SSRS)
Filtri di uso comune ( Generatore report e SSRS ) Commonly Used Filters (Report Builder and SSRS)
Aggiungere, modificare o eliminare un parametro di Report ( Generatore report e SSRS ) Add, Change, or Delete a Report Parameter (Report Builder and SSRS)
Esercitazione: Aggiungere un parametro di Report ( Generatore report ) Tutorial: Add a Parameter to Your Report (Report Builder)
Esercitazioni di Generatore report Report Builder Tutorials
Raccolte predefinite nelle espressioni ( Generatore report e SSRS )Built-in Collections in Expressions (Report Builder and SSRS)