Utilizzo di parametri nelle espressioni

Articolo
12/15/2008

Data creazione: 17 luglio 2006

In questo argomento sono riportati diversi esempi della sintassi necessaria per includere riferimenti a parametri di report in un'espressione. I parametri di report rappresentano uno degli insiemi globali cui è possibile fare riferimento in un'espressione. Per ulteriori informazioni, vedere Utilizzo di insiemi Global nelle espressioni (Reporting Services).

I parametri vengono restituiti durante l'elaborazione di un report. È possibile utilizzare le espressioni ovunque in una proprietà dell'elemento di report o della casella di testo che include l'opzione (Fx) o <Espressione>. Per esempi su dove è possibile utilizzare le espressioni, vedere Esempi di espressioni in Reporting Services.

I parametri di report possono essere dei tipi seguenti: Boolean, DateTime, Integer, Float o String. Possono essere a valore singolo e multivalore. È possibile impostare la proprietà multivalore per tutti i tipi ad eccezione di Boolean. Un parametro multivalore è costituito da una matrice di valori in base zero. Per ulteriori informazioni sull'impostazione delle proprietà del report, vedere Creazione dei parametri del report e impostazione delle relative proprietà.

Parametri a valore singolo

Nella tabella seguente sono riportati esempi di utilizzo di un parametro a valore singolo in un'espressione.

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 un insieme di oggetti. Se è False, il parametro è a valore singolo ed è costituito da un solo oggetto.
`=Parameters!`<ParameterName>`.Count`	Restituisce il valore integer 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à Label 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.

Impostazione di un filtro tramite un parametro a valore singolo

Per impostare i filtri, viene utilizzata la scheda Filtro delle pagine delle proprietà di set di dati, aree dati o raggruppamenti di dati. È possibile definire l'espressione di filtro immettendo valori nella griglia filtri della scheda Filtro. La tabella seguente rappresenta la griglia filtri. Nell'esempio seguente si presuppone che il tipo di dati dei valori di Fields!EmployeeID.Value e Parameters!EmployeeID.Value sia identico.

Espressione (filtro) Operatore Valore And/Or

Espressione (filtro)	Operatore	Valore	And/Or
`= Fields!`<FieldName>`.Value`	Qualsiasi operatore che consente di confrontare due valori. Ad esempio: = >= <	`=Parameters!`<ParameterName>`.Value`	Valore preimpostato attivato quando si immettono più espressioni.

= Fields!<FieldName>.Value

Qualsiasi operatore che consente di confrontare due valori. Ad esempio:

=Parameters!<ParameterName>.Value

Valore preimpostato attivato quando si immettono più espressioni.

Parametri multivalore

Nella tabella seguente sono riportati esempi di utilizzo di un parametro multivalore in un'espressione.

Utilizzo di un parametro multivalore in un'espressione

È possibile utilizzare le espressioni ovunque in una proprietà dell'elemento di report o della casella di testo che include l'opzione (Fx) o <Espressione>.

Esempio	Descrizione
`=Parameters!`<MultivalueParameterName>`.IsMultiValue`	Restituisce True o False. Verifica se un parametro è multivalore. Se è True, il parametro è multivalore ed è costituito da un insieme di oggetti. Se è False, il parametro è a valore singolo ed è costituito da un solo oggetto.
`=Parameters!`<MultivalueParameterName>`.Count`	Restituisce un valore integer. Fare 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 String. È 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 una stringa costituita da un elenco di valori delimitati da virgole in un parametro multivalore. È possibile utilizzare qualsiasi delimitatore nel secondo parametro per unire.

Impostazione di un filtro tramite un parametro multivalore

Per impostare i filtri, viene utilizzata la scheda Filtro delle pagine delle proprietà di set di dati, aree dati o raggruppamenti di dati. Nell'esempio seguente si presuppone che il tipo di dati dei valori di Fields!EmployeeID.Value e Parameters!EmployeeID.Value sia identico. I parametri multivalore possono essere visualizzati solo nella colonna Valore.

Espressione	Operatore	Valore	And/Or
`= Fields!`<FieldName>`.Value`	Operatore che consente di testare l'inclusione di set. L'unica scelta disponibile è: `IN`	`=Parameters!`<MultivalueParameterName>`.Value`	Valore preimpostato attivato quando si immettono più espressioni.

Esempi di aggiunta di riferimenti a parametri da codice personalizzato

È possibile fare riferimento all'insieme globale di parametri tramite codice personalizzato in un blocco di codice della definizione del report oppure in un assembly personalizzato specificato dall'utente. L'insieme di parametri è di sola lettura e non include iteratori pubblici. Non è possibile utilizzare un costrutto For Each di Visual Basic per esaminare l'insieme parametro per parametro. È necessario conoscere il nome di un parametro definito in una definizione di report per potervi fare riferimento nel codice personalizzato. È tuttavia possibile eseguire un'iterazione di tutti i valori di un parametro multivalore. Per ulteriori informazioni, vedere Utilizzo di riferimenti a codice personalizzato nelle espressioni (Reporting Services).

Descrizione Riferimento nell'espressione Definizione del codice personalizzato

Descrizione	Riferimento nell'espressione	Definizione del codice personalizzato
Passaggio dell'intero insieme globale di parametri al codice personalizzato. Questa funzione restituisce il valore di un parametro di report MyParameter specifico.	`=Code.DisplayAParameterValue(Parameters)`	`Public Function DisplayAParameterValue(` `ByVal parameters as Parameters) as Object` `Return parameters("MyParameter").Value` `End Function`
Passaggio di un singolo parametro al codice personalizzato. In questo esempio viene restituito il valore del parametro passato. Se il parametro è multivalore, la stringa restituita sarà costituita da una concatenazione di tutti i valori.	`=Code.ShowParametersValues(Parameters!DayOfTheWeek)`	`Public Function ShowParameterValues(ByVal parameter as Parameter) as String Dim s as String If parameter.IsMultiValue then s = "Multivalue: " For i as integer = 0 to parameter.Count-1 s = s + CStr(parameter.Value(i)) + " " Next Else s = "Single value: " + CStr(parameter.Value) End If Return s End Function`

Passaggio dell'intero insieme globale di parametri al codice personalizzato. Questa funzione restituisce il valore di un parametro di report MyParameter specifico.

=Code.DisplayAParameterValue(Parameters)

Public Function DisplayAParameterValue(

ByVal parameters as Parameters) as Object

Return parameters("MyParameter").Value

End Function

Passaggio di un singolo parametro al codice personalizzato. In questo esempio viene restituito il valore del parametro passato. Se il parametro è multivalore, la stringa restituita sarà costituita da una concatenazione di tutti i valori.

=Code.ShowParametersValues(Parameters!DayOfTheWeek)

Public Function ShowParameterValues(ByVal parameter as Parameter)
 as String
   Dim s as String 
   If parameter.IsMultiValue then
      s = "Multivalue: " 
      For i as integer = 0 to parameter.Count-1
         s = s + CStr(parameter.Value(i)) + " " 
      Next
   Else
      s = "Single value: " + CStr(parameter.Value)
   End If
   Return s
End Function

Vedere anche

Condividi tramite

Utilizzo di parametri nelle espressioni

Parametri a valore singolo

Utilizzo di un parametro a valore singolo in un'espressione

Impostazione di un filtro tramite un parametro a valore singolo

Parametri multivalore

Utilizzo di un parametro multivalore in un'espressione

Impostazione di un filtro tramite un parametro multivalore

Esempi di aggiunta di riferimenti a parametri da codice personalizzato

Vedere anche

Attività

Riferimento

Concetti

Altre risorse

Guida in linea e informazioni

Risorse aggiuntive