Fonction précédente (Générateur de rapports et SSRS)

Retourne la valeur ou la valeur d'agrégation spécifiée pour l'instance précédente d'un élément dans l'étendue spécifiée.

Syntaxe

  
Previous(expression, scope)  

Paramètres

expression
(Variant ou Binary) Expression à utiliser pour identifier les données et pour lesquelles récupérer la valeur précédente, par exemple, Fields!Fieldname.Value ou Sum(Fields!Fieldname.Value).

étendue
(String) Facultatif. Nom d’un groupe ou d’une région de données, ou null (Nothing en Visual Basic), qui spécifie l’étendue à partir de laquelle récupérer la valeur précédente spécifiée par l’expression.

Type renvoyé

Retourne un Variant ou Binary.

Remarques

La Previous fonction retourne la valeur précédente de l’expression évaluée dans l’étendue spécifiée après l’application de tous les tris et filtrages.

Si l’expression ne contient pas d’agrégat, la Previous fonction est définie par défaut sur l’étendue actuelle de l’élément de rapport.

Dans un groupe de détails, utilisez Previous pour spécifier la valeur d’une référence de champ dans l’instance précédente de la ligne de détail.

Si l’expression contient une fonction d’agrégation qui utilise une étendue par défaut, Previous agrège les données dans l’instance précédente de l’étendue spécifiée dans l’appel de fonction d’agrégation.

Si l’expression contient une fonction d’agrégation qui spécifie une étendue autre que la portée par défaut, le paramètre d’étendue de la Previous fonction doit être une étendue contenante pour l’étendue spécifiée dans l’appel de fonction d’agrégation.

Les fonctions Level, InScopeAggregate et Previous ne peuvent pas être utilisées dans le paramètre d’expression. La spécification du paramètre recursive pour une fonction d’agrégation n’est pas prise en charge.

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).

Exemples

Descriptif

L’exemple de code ci-dessous, quand il est placé sur la ligne de données par défaut d’une région de données, fournit la valeur du champ LineTotal de la ligne précédente.

Code

=Previous(Fields!LineTotal.Value)  

Descriptif

L'exemple suivant montre une expression qui calcule la somme des ventes réalisées au cours d'un jour spécifique du mois et la valeur précédente pour le même jour du mois d'une année précédente. L’expression est ajoutée à une cellule d’une ligne qui appartient au groupe enfant GroupbyDay. Son groupe parent est GroupbyMonth, ayant lui-même le groupe parent GroupbyYear. L'expression affiche les résultats pour GroupbyDay (étendue par défaut), puis pour GroupbyYear (le parent du groupe parent GroupbyMonth).

Par exemple, pour une région de données avec un groupe parent nommé Year, son groupe enfant nommé Monthet son groupe enfant nommé Day (3 niveaux imbriqués). L’expression =Previous(Sum(Fields!Sales.Value,"Day"),"Year") d’une ligne associée au groupe Day retourne la valeur des ventes réalisées le même jour du même mois de l’année précédente.

Code

=Sum(Fields!Sales.Value) & " " & Previous(Sum(Fields!Sales.Value,"GroupbyDay"),"GroupbyYear")  

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)