Funzione RunningValue (Generatore report e SSRS)

  • Articolo

Viene restituita 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 ulteriori informazioni, vedere Progettazione di report tramite Progettazione report e Generatore report (SSRS) nel Web all'indirizzo 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.

  • scope
    (String) Costante di tipo stringa ovvero il nome di un set di dati, area dati o gruppo oppure valore Null (Nothing in Visual Basic) tramite cui viene specificato 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, utilizzare funzioni di conversione come CInt, CDbl o CDec. Per ulteriori 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.

  • Expression non deve contenere funzioni First, Last, Previous o RunningValue.

  • Expression non deve contenere aggregazioni nidificate che specificano recursive.

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

Per ulteriori 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 ulteriori informazioni sulle aggregazioni ricorsive, vedere Creazione di gruppi di gerarchie ricorsive (Generatore report e SSRS).

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)

Vedere anche

Riferimento

Esempi di espressioni (Generatore report e SSRS)

Concetti

Utilizzo delle espressioni nei report (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)