Condividi tramite


Funzione RunningValue (Generatore report e SSRS)

Restituisce un'aggregazione parziale di tutti i valori numerici non Null specificati dall'espressione, valutata per l'ambito specificato.

Nota

È possibile creare e modificare definizioni del report (con estensione rdl) in Generatore report e in Progettazione report di SQL Server Data Tools. Ogni ambiente di creazione offre modalità differenti per creare, aprire e salvare report ed elementi correlati. Per altre informazioni, vedere Progettazione di report in Progettazione report e Report Builder (SSRS) sul Web in microsoft.com.

Sintassi

  
RunningValue(expression, function, scope)  

Parametri

expression
Espressione su cui eseguire l'aggregazione, ad esempio [Quantity].

function
(Enum) Nome della funzione di aggregazione da applicare all'espressione, ad esempio Sum. Tale funzione non può essere RunningValue, RowNumber o Aggregate.

ambito
(String) Costante stringa che rappresenta il nome di un set di dati, un'area dati o un gruppo o null (Nothing in Visual Basic), che specifica il contesto in cui valutare l'aggregazione. Tramite Nothing viene specificato il contesto più esterno, generalmente il set di dati del report.

Tipo restituito

Dipende dalla funzione di aggregazione specificata nel parametro function .

Osservazioni

Il valore per RunningValue viene reimpostato su 0 per ogni nuova istanza dell'ambito. Se viene specificato un gruppo, il valore corrente viene reimpostato quando viene modificata l'espressione di raggruppamento. Se viene specificata un'area dati, il valore corrente viene reimpostato per ogni nuova istanza dell'area dati. Se viene specificato un set di dati, il valore corrente non viene reimpostato nell'intero set di dati.

RunningValue non può essere utilizzato in un filtro o un'espressione di ordinamento.

Il set di dati per il quale il valore corrente è calcolato deve avere lo stesso tipo di dati. Per convertire dati con più tipi di dati numerici nello stesso tipo di dati, usare funzioni di conversione come CInt, CDbl o CDec. Per altre informazioni, vedere Funzioni di conversione del tipo.

Scope non può essere un'espressione.

Expression può contenere chiamate alle funzioni di aggregazione nidificate con le eccezioni e le condizioni seguenti:

  • Scope per le aggregazioni nidificate deve corrispondere o essere contenuto nell'ambito dell'aggregazione esterna. Per tutti gli ambiti distinti nell'espressione, un ambito deve essere in una relazione figlio con tutti gli altri ambiti.

  • Scope per le aggregazioni nidificate non può essere il nome di un set di dati.

  • L'espressione non deve contenere Firstfunzioni , Last, Previouso RunningValue .

  • Expression non deve contenere aggregazioni nidificate che specificano recursive.

Per calcolare il valore corrente del numero di righe, utilizzare RowNumber. Per altre informazioni, vedere Funzione RowNumber (Generatore report e SSRS).

Per altre informazioni, vedere Riferimento a funzioni di aggregazione (Generatore report e SSRS) e Ambito di espressioni per totali, aggregazioni e raccolte predefinite (Generatore report e SSRS).

Per altre informazioni sulle aggregazioni ricorsive, vedere Creazione di gruppi di gerarchie ricorsive (Generatore report e SSRS).

Esempi

L'esempio di codice seguente consente di ottenere una somma parziale del campo denominato Cost nell'ambito più esterno, che corrisponde al set di dati.

=RunningValue(Fields!Cost.Value, Sum, Nothing)  

L'esempio di codice seguente consente di ottenere una somma parziale del campo denominato Score nel set di dati denominato DataSet1.

=RunningValue(Fields!Score.Value,sum,"DataSet1")  

L'esempio di codice seguente consente di ottenere una somma parziale del campo denominato Traffic Charges nell'ambito più esterno.

=RunningValue(Fields!Traffic Charges.Value, Sum, Nothing)  

Vedere anche

Utilizzo delle espressioni nei report (Generatore report e SSRS)
Esempi di espressioni (Generatore report e SSRS)
Tipi di dati nelle espressioni (Generatore report e SSRS)
Ambito di espressioni per totali, aggregazioni e raccolte predefinite (Generatore report e SSRS)