Partager via


Fonction RunningValue (Générateur de rapports et SSRS)

Retourne un agrégat cumulé de toutes les valeurs numériques non Null spécifiées par l'expression, évaluée pour l'étendue donnée.

Remarque

Vous pouvez créer et modifier des définitions de rapport (.rdl) dans le Générateur de rapports et dans le Concepteur de rapports dans SQL Server Data Tools. Chaque environnement de création offre différentes façons de créer, d’ouvrir et d’enregistrer des rapports et des éléments associés. Pour plus d’informations, consultez Conception de rapports dans le Concepteur de rapports et le Générateur de rapports (SSRS) sur le web à microsoft.com.

Syntaxe

  
RunningValue(expression, function, scope)  

Paramètres

expression
Expression sur laquelle effectuer l’agrégation, par exemple [Quantity].

fonction
(Enum) Nom de la fonction d’agrégation à appliquer à l’expression, par exemple Sum. Cette fonction ne peut pas être RunningValue, RowNumberou Aggregate.

étendue
(String) Constante de chaîne qui est le nom d’un jeu de données, d’une région de données ou d’un groupe, ou null (Nothing en Visual Basic), qui spécifie le contexte dans lequel évaluer l’agrégation. Nothing spécifie le contexte le plus externe, généralement le jeu de données du rapport.

Type renvoyé

Déterminé par la fonction d'agrégation spécifiée dans le paramètre function .

Remarques

La valeur pour RunningValue se réinitialise à 0 pour chaque nouvelle instance du contexte. 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, la valeur d'exécution n'est pas réinitialisée dans l'ensemble du dataset.

RunningValue ne peut pas être utilisé dans un filtre ou une expression de tri.

Le jeu des données pour lequel la valeur d'exécution est calculée doit avoir le même type de données. Pour convertir des données qui ont plusieurs types de données numériques en 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.

Expression peut contenir des appels aux fonctions d'agrégation imbriquées avec les exceptions et conditions suivantes :

  • Le paramètre Scope des agrégats imbriqués doit être identique à l'étendue de l'agrégat externe ou contenu par celle-ci. Pour toutes les étendues distinctes de l'expression, une étendue doit figurer dans une relation enfant avec toutes les autres étendues.

  • Le paramètre Scope des agrégats imbriqués ne peut pas être le nom d'un dataset.

  • L’expression ne doit pas contenirFirst, Lastou PreviousRunningValue les fonctions.

  • Expression ne doit pas contenir les agrégats imbriqués qui spécifient recursive.

Pour calculer la valeur en cours d’exécution du nombre de lignes, utilisez RowNumber. Pour plus d’informations, consultez Fonction RowNumber (Générateur de rapports et SSRS).

Pour plus d’informations, consultez Référence aux fonctions d’agrégation (Générateur de rapports et SSRS) et Étendue des expressions pour les totaux, les agrégats et les collections intégrées (Générateur de rapports et SSRS).

Pour plus d’informations sur les agrégats récursifs, consultez Création de groupes de hiérarchies récursives (Générateur de rapports et SSRS).

Exemples

L'exemple de code suivant fournit le cumul du champ nommé Cost de l'étendue la plus à l'extérieur, à savoir le dataset.

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

L'exemple de code suivant fournit le cumul du champ nommé Score dans le dataset nommé DataSet1.

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

L'exemple de code suivant fournit le cumul du champ nommé Traffic Charges dans l'étendue la plus à l'extérieure.

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

Voir aussi

Utilisation d'expressions dans les rapports (Générateur de rapport et SSRS)
Exemples d'expressions (Générateur de rapports et SSRS)
Types de données dans les expressions (Générateur de rapports et SSRS)
Étendue des expressions pour les totaux, les agrégats et les collections intégrées (Générateur de rapports et SSRS)