Report Builder funzioni - funzione RunningValueReport Builder Functions - RunningValue Function

Restituisce un'aggregazione parziale di tutti i valori numerici non Null specificati dall'espressione, valutata per l'ambito specificato.Returns a running aggregate of all non-null numeric values specified by the expression, evaluated for the given scope.

Nota

È possibile creare e modificare file di definizioni report impaginati (con estensione rdl) in Generatore report e in Progettazione report di SQL Server Data Tools.You can create and modify paginated report definition (.rdl) files in Report Builder and in Report Designer in SQL Server Data Tools. Ogni ambiente di creazione offre modalità differenti per creare, aprire e salvare report ed elementi correlati.Each authoring environment provides different ways to create, open, and save reports and related items.

SintassiSyntax


RunningValue(expression, function, scope)  

ParametriParameters

espressioneexpression
Espressione su cui eseguire l'aggregazione, ad esempio [Quantity].The expression on which to perform the aggregation, for example, [Quantity].

functionfunction
(Enum) Nome della funzione di aggregazione da applicare all'espressione, ad esempio Sum.(Enum) The name of the aggregate function to apply to the expression, for example, Sum. Tale funzione non può essere RunningValue, RowNumbero Aggregate.This function cannot be RunningValue, RowNumber, or Aggregate.

ambitoscope
(String) Costante di tipo stringa ovvero il nome di un set di dati, area dati o gruppo oppure valore Null (Nothing in Visual BasicVisual Basic) tramite cui viene specificato il contesto in cui valutare l'aggregazione.(String) A string constant that is the name of a dataset, data region, or group, or null (Nothing in Visual BasicVisual Basic), that specifies the context in which to evaluate the aggregation. TramiteNothing viene specificato il contesto più esterno, generalmente il set di dati del report.Nothing specifies the outermost context, usually the report dataset.

Tipo restituitoReturn Type

Dipende dalla funzione di aggregazione specificata nel parametro function .Determined by the aggregate function that is specified in the function parameter.

OsservazioniRemarks

Il valore per RunningValue viene reimpostato su 0 per ogni nuova istanza dell'ambito.The value for RunningValue resets to 0 for each new instance of the scope. Se viene specificato un gruppo, il valore corrente viene reimpostato quando viene modificata l'espressione di raggruppamento.If a group is specified, the running value is reset when the group expression changes. Se viene specificata un'area dati, il valore corrente viene reimpostato per ogni nuova istanza dell'area dati.If a data region is specified, the running value is reset for each new instance of the data region. Se viene specificato un set di dati, il valore corrente non viene reimpostato nell'intero set di dati.If a dataset is specified, the running value is not reset throughout the entire dataset.

RunningValue non può essere usato in un filtro o un'espressione di ordinamento.RunningValue cannot be used in a filter or sort expression.

Il set di dati per il quale il valore corrente è calcolato deve avere lo stesso tipo di dati.The set of data for which the running value is calculated must have the same data type. Per convertire dati con più tipi di dati numerici nello stesso tipo di dati, usare funzioni di conversione come CInt, CDbl o CDec.To convert data that has multiple numeric data types to the same data type, use conversion functions like CInt, CDbl or CDec. Per altre informazioni, vedere Funzioni di conversione del tipo.For more information, see Type Conversion Functions.

Scope non può essere un'espressione.Scope cannot be an expression.

Expression può contenere chiamate alle funzioni di aggregazione nidificate con le eccezioni e le condizioni seguenti:Expression can contain calls to nested aggregate functions with the following exceptions and conditions:

EsempiExamples

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.The following code example provides a running sum of the field named Cost in the outermost scope, which is the dataset.

=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.The following code example provides a running sum of the field named Score in the dataset named 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.The following code example provides a running sum of the field named Traffic Charges in the outermost scope.

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

Vedere ancheSee Also

Utilizzo delle espressioni nei report ( Generatore report e SSRS ) Expression Uses in Reports (Report Builder and SSRS)
Esempi di espressioni ( Generatore report e SSRS ) Expression Examples (Report Builder and SSRS)
Tipi di dati in espressioni ( Generatore report e SSRS ) Data Types in Expressions (Report Builder and SSRS)
Ambito di espressioni per totali, aggregazioni e raccolte predefinite ( Generatore report e SSRS )Expression Scope for Totals, Aggregates, and Built-in Collections (Report Builder and SSRS)