Funzioni incorporate per report (Progettazione report di Visual Studio)

In ReportViewer sono disponibili funzioni incorporate utilizzabili nelle espressioni del report. Le funzioni incorporate possono essere utilizzate in espressioni incluse nei file di definizione del report del client (estensione .rdlc) e nei file di definizione del report (estensione .rdl) elaborati su un server di report SQL Server 2005 Reporting Services. Il supporto per le funzioni è fornito dai controlli ReportViewer e da Reporting Services.

Tali funzioni sono organizzate in due categorie: aggregazioni e funzioni varie. Esempi di aggregazione dei dati includono il calcolo della somma di tutti i valori in un campo specifico tramite la funzione Sum. È possibile utilizzare funzioni di aggregazione all'interno di espressioni per qualsiasi elemento del report.

Oltre alle funzioni incorporate, nelle espressioni incluse nei report è possibile utilizzare qualsiasi funzione di Visual Basic. Per ulteriori informazioni sulle funzioni di Visual Basic, vedere Funzioni (Visual Basic).

Funzioni varie

Nella tabella seguente sono descritte le funzioni generiche disponibili.

Funzione Descrizione

Funzione InScope (Progettazione report di Visual Studio)

Indica se l'istanza corrente di un elemento è inclusa nell'ambito specificato.

Funzione Level (Progettazione report di Visual Studio)

Restituisce il livello di nidificazione corrente in una gerarchia ricorsiva.

Funzione Previous (Progettazione report di Visual Studio)

Restituisce l'istanza precedente dall'ambito specificato.

Aggregazioni standard

Nella tabella seguente sono descritte le funzioni di aggregazione standard disponibili.

Funzione Descrizione

Avg

Restituisce la media di tutti i valori non Null dall'espressione specificata.

Count

Restituisce un conteggio dei valori dall'espressione specificata.

CountDistinct

Restituisce un conteggio di tutti i valori distinct dall'espressione specificata.

CountRows

Restituisce un conteggio delle righe incluse nell'ambito specificato.

First

Restituisce il primo valore dall'espressione specificata.

Last

Restituisce l'ultimo valore dall'espressione specificata.

Max

Restituisce il valore massimo da tutti i valori non Null dell'espressione specificata.

Min

Restituisce il valore minimo da tutti i valori non Null dell'espressione specificata.

StDev

Restituisce la deviazione standard di tutti i valori non Null dell'espressione specificata.

StDevP

Restituisce la deviazione standard della popolazione di tutti i valori non Null dell'espressione specificata.

Sum

Restituisce una somma dei valori dell'espressione specificata.

Var

Restituisce la varianza di tutti i valori non Null dell'espressione specificata.

VarP

Restituisce la varianza della popolazione di tutti i valori non Null dell'espressione specificata.

Aggregazioni parziali

Nella tabella seguente sono descritte le funzioni di aggregazione parziali disponibili.

Funzione Descrizione

RowNumber

Restituisce un conteggio parziale di tutte le righe incluse nell'ambito specificato.

RunningValue

Utilizza una funzione specifica per restituire un'aggregazione parziale dell'espressione specificata.

Aggregazioni personalizzate

Nella tabella seguente viene descritta la funzione di aggregazione personalizzata.

Funzione Descrizione

Aggregate

Restituisce un'aggregazione personalizzata dell'espressione specificata, secondo quanto definito dal provider di dati.

Ambito

Ogni funzione di aggregazione utilizza il parametro Scope, che definisce l'ambito di esecuzione della funzione di aggregazione. Un ambito valido è costituito dal nome di un raggruppamento, di un set di dati o di un'area dati. È possibile utilizzare come ambito solo i raggruppamenti o le aree dati che contengono direttamente o indirettamente l'espressione. Nel caso di espressioni incluse in aree dati, il parametro Scope è facoltativo per tutte le funzioni di aggregazione. Se si omette il parametro Scope, l'ambito della funzione di aggregazione sarà costituito dall'area dati o dal raggruppamento più interno cui appartiene l'elemento del report. Se si specifica la parola chiave Nothing, l'ambito corrisponderà all'area dati più esterna cui appartiene l'elemento del report.

Nel caso di espressioni non incluse in aree dati, il parametro Scope si riferisce a una tabella di dati o a un oggetto business. Se un report include più set di dati, il parametro Scope è obbligatorio. Se un report include solo un set di dati e Scope viene omesso, l'ambito verrà impostato sul set di dati. Non è possibile specificare la parola chiave Nothing per elementi del report non inclusi in un'area dati.

L'utilizzo del parametro Scope non è consentito nelle intestazioni o nei piè di pagina.

Vedere anche

Concetti

Creazione di origini dei dati per un report
Utilizzo di espressioni in un report (Progettazione report di Visual Studio)
Controlli ReportViewer (Visual Studio)
Panoramica sui report (Visual Studio)