Funzione RunningValue (Generatore report 2.0)
Restituisce un'aggregazione parziale di tutti i valori numerici non Null specificati dall'espressione, valutata per l'ambito specificato.
Sintassi
RunningValue(expression, function, scope)
Parametri
expression
Espressione su cui eseguire l'aggregazione, ad esempio [Quantity]. L'espressione non può contenere funzioni di aggregazione.function
(Enum) Nome della funzione di aggregazione da applicare all'espressione, ad esempio Sum. Tale funzione non può essere RunningValue, RowNumber o Aggregate.scope
(String) Nome di un set di dati, area dati o gruppo oppure valore Null (Nothing in Visual Basic) che specifica il contesto in cui valutare l'aggregazione. Nothing specifica il contesto più esterno, che solitamente corrisponde al set di dati del report. Per ulteriori informazioni, vedere Utilizzo delle funzioni predefinite di report e aggregazione nelle espressioni (Generatore report 2.0) e Calcolo dei totali e di altre aggregazioni (Generatore report 2.0).
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.
Le restrizioni per RunningValue sono determinate anche dalla funzione di aggregazione specificata nel parametro function. Non è possibile utilizzare RunningValue in un'espressione di filtro o di ordinamento.
Il set di dati specificato nell'espressione deve essere dello stesso tipo di dati. Per convertire dati con più tipi di dati numerici nello stesso tipo di dati, utilizzare funzioni di conversione come CInt, CDbl o CDec. Per ulteriori informazioni, vedere Funzioni di conversione del tipo.
Scope non può essere un'espressione.
Per calcolare il valore corrente del numero di righe, utilizzare RowNumber. Per ulteriori informazioni, vedere Funzione RowNumber (Generatore report 2.0).
Descrizione
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.
Codice
=RunningValue(Fields!Cost.Value, Sum, Nothing)