Fonction RunningValue (Générateur de rapports version 2.0)
Retourne un agrégat cumulé de toutes les valeurs numériques non Null spécifiées par l'expression, évalué pour l'étendue donnée.
Syntaxe
RunningValue(expression, function, scope)
Paramètres
expression
Expression sur laquelle effectuer l'agrégation, par exemple, [Quantity]. Cette expression ne peut pas contenir de fonctions d'agrégation.function
(Enum) Nom de la fonction d'agrégation à appliquer à l'expression, par exemple, Sum. Cette fonction ne peut pas être de type RunningValue, RowNumber ou Aggregate.scope
(String) Nom d'un dataset, d'une région de données ou d'un groupe, ou valeur Null (Nothing en Visual Basic), qui spécifie le contexte dans lequel évaluer l'agrégation. Nothing spécifie le contexte le plus extérieur, généralement le dataset du rapport. Pour plus d'informations, consultez Utilisation de fonctions de rapport et d'agrégation intégrées dans des expressions (Générateur de rapports version 2.0) et Calcul de totaux et autres agrégats (Générateur de rapports version 2.0).
Type de retour
Déterminé par la fonction d'agrégation spécifiée dans le paramètre function.
Notes
La valeur de RunningValue se réinitialise à 0 pour chaque nouvelle instance de l'étendue. Si vous spécifiez un groupe, la valeur d'exécution est réinitialisée lorsque l'expression de groupe change. Si vous indiquez une région de données, le cumul est réinitialisé pour chaque nouvelle instance de la région de données. Si vous spécifiez un dataset, le cumul n'est pas réinitialisé dans l'ensemble du dataset.
Les restrictions relatives à RunningValue dépendent également de la fonction d'agrégation définie à l'aide du paramètre function. RunningValue ne peut pas être utilisé dans une expression de filtre ou de tri.
Le jeu de données spécifié dans l'expression doit avoir le même type de données. Pour convertir des données qui ont plusieurs types de données numériques en un même type de données, utilisez des fonctions de conversion telles que CInt, CDbl ou CDec. Pour plus d'informations, consultez Fonctions de conversion de types de données.
Scope ne peut pas être une expression.
Pour calculer la valeur d'exécution du nombre de lignes, utilisez RowNumber. Pour plus d'informations, consultez Fonction RowNumber (Générateur de rapports version 2.0).
Description
L'exemple de code suivant fournit une somme cumulée du champ nommé Cost de l'étendue la plus à l'extérieur, à savoir, le dataset.
Code
=RunningValue(Fields!Cost.Value, Sum, Nothing)