Raccolte predefinite - Riferimenti alla raccolta di parametri in un report impaginato (Generatore report)

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

I parametri di un report impaginato sono una delle raccolte predefinite a cui è possibile fare riferimento da un'espressione. Includendo parametri in un'espressione, è possibile personalizzare i dati e l'aspetto dei report in base alle opzioni scelte da un utente. È possibile usare le espressioni per qualsiasi proprietà degli elementi del report o delle caselle di testo che includa l'opzione (Fx) o <Espressione>. Le espressioni vengono anche utilizzate per controllare il contenuto e l'aspetto dei report in altri modi. Per altre informazioni, vedere Esempi di espressioni (Generatore report e 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. I parametri dei report possono essere dei tipi seguenti: Boolean, DateTime, Integer, Float o Text, che rappresenta il tipo di dati stringa sottostante. Può essere necessario convertire il tipo di dati del valore del parametro in base al valore del set di dati. Per altre informazioni, vedere Tipi di dati nelle espressioni (Generatore report e 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.

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 di un parametro a valore singolo in un'espressione

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.

Esempio	Descrizione
=Parameters!<ParameterName>.IsMultiValue	Restituisce False. Verifica se un parametro è multivalore. Se è True, il parametro è multivalore ed è costituito da una raccolta di oggetti. Se è False, il parametro è a valore singolo ed è costituito da un solo oggetto.
=Parameters!<ParameterName>.Count	Restituisce il valore intero 1. Per un parametro a valore singolo, il conteggio è sempre 1.
=Parameters!<ParameterName>.Label	Restituisce l'etichetta del parametro, utilizzata di frequente come nome visualizzato in un elenco a discesa di valori disponibili.
=Parameters!<ParameterName>.Value	Restituisce il valore del parametro. Se la proprietà Etichetta non è stata impostata, questo valore verrà visualizzato nell'elenco a discesa dei valori disponibili.
=CStr(Parameters!<ParameterName>.Value)	Restituisce il valore del parametro sotto forma di stringa.
=Fields(Parameters!<ParameterName>.Value).Value	Restituisce il valore del campo il cui nome è uguale a quello del parametro.

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).

Utilizzo di un parametro multivalore in un'espressione

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.

Esempio	Descrizione
=Parameters!<MultivalueParameterName>.IsMultiValue	Restituisce True o False. Verifica se un parametro è multivalore. Se è True, il parametro è multivalore ed è costituito da una raccolta di oggetti. Se è False, il parametro è a valore singolo ed è costituito da un solo oggetto.
=Parameters!<MultivalueParameterName>.Count	Restituisce un valore intero. Fa riferimento al numero di valori. Per un parametro a valore singolo, il conteggio è sempre 1. Per un parametro multivalore, il conteggio è 0 o maggiore di zero.
=Parameters!<MultivalueParameterName>.Value(0)	Restituisce il primo valore di un parametro multivalore.
=Parameters!<MultivalueParameterName>.Value(Parameters!<MultivalueParameterName>.Count-1)	Restituisce l'ultimo valore di un parametro multivalore.
=Split("Value1,Value2,Value3",",")	Restituisce una matrice di valori. Creare una matrice di valori per un parametro multivalore di tipo Stringa . È possibile utilizzare qualsiasi delimitatore nel secondo parametro per dividere. È 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.
=Join(Parameters!<MultivalueParameterName>.Value,", ")	Restituisce un oggetto Stringa costituito da un elenco di valori delimitati da virgole in un parametro multivalore. È possibile utilizzare qualsiasi delimitatore nel secondo parametro per unire.

Per altre informazioni sull'uso dei parametri in un filtro, vedere Parametri report (Generatore report e Progettazione report).

Vedi anche

Espressioni (Generatore di report e SSRS)
Filtri di uso comune (Generatore di report e SSRS)
Aggiungere, modificare o eliminare un parametro di report (Generatore di report e SSRS)
Esercitazione: Aggiungere un parametro al report (Generatore report)
Esercitazioni di Generatore report
Raccolte predefinite nelle espressioni (Generatore di report e SSRS)