Condividi tramite

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

  • Articolo

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 <Expression>. 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 di report).

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

Per includere un riferimento a un parametro in un'espressione, è necessario essere in grado di specificare la sintassi corretta per tale riferimento. La sintassi varia a seconda che il parametro sia un parametro 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 di valori disponibili.
=Parameters! <ParameterName> .Value Restituisce il valore del parametro. Se la proprietà Etichetta non è stata impostata, questo valore verrà visualizzato nell'elenco di 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 di report).

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 di report e Progettazione report).

Contenuto correlato