Fonctions intégrées pour les rapports (Concepteur de rapports Visual Studio)

ReportViewer fournit des fonctions intégrées que vous pouvez utiliser dans des expressions de rapport. Les fonctions intégrées peuvent être utilisées dans des expressions que vous incluez dans des fichiers de définition de rapport client (.rdlc) et dans des fichiers de définition de rapport (.rdl) sur un serveur de rapports SQL Server 2005 Reporting Services. La prise en charge des fonctions est fournie par les contrôles ReportViewer et Reporting Services.

Les fonctions intégrées sont organisées en deux categories : fonctions d'agrégation et fonctions diverses. Exemple d'agrégation de données : calcul d'une somme de toutes les valeurs d'un champ particulier au moyen de la fonction Sum. Vous pouvez utiliser des fonctions d'agrégation dans des expressions pour tout élément de rapport.

Outre les fonctions intégrées, les expressions que vous incluez dans des rapports peuvent utiliser n'importe quelle fonction Visual Basic. Pour plus d'informations sur les fonctions Visual Basic, consultez Fonctions (Visual Basic).

Fonctions diverses

Le tableau suivant décrit les fonctions d'usage général dont vous disposez.

Fonction	Description
Fonction InScope (Concepteur de rapports Visual Studio)	Indique si l'instance en cours d'un élément se trouve dans l'étendue spécifiée.
Fonction Level (Concepteur de rapports Visual Studio)	Retourne le niveau de profondeur actuel d'une hiérarchie récursive.
Fonction Previous (Concepteur de rapports Visual Studio)	Retourne l'instance précédente dans l'étendue spécifiée.

Agrégations standard

Le tableau suivant décrit les fonctions d'agrégation standard dont vous disposez.

Fonction	Description
Avg	Retourne la moyenne de toutes les valeurs non nulles de l'expression spécifiée.
Count	Retourne le nombre de valeurs de l'expression spécifiée.
CountDistinct	Retourne le nombre de toutes les valeurs distinctes de l'expression spécifiée.
CountRows	Retourne le nombre de lignes de l'étendue spécifiée.
First	Retourne la première valeur de l'expression spécifiée.
Last	Retourne la dernière valeur de l'expression spécifiée.
Max	Retourne la valeur maximale de toutes les valeurs non nulles de l'expression spécifiée.
Min	Retourne la valeur minimale de toutes les valeurs non nulles de l'expression spécifiée.
StDev	Retourne l'écart-type standard de toutes les valeurs non nulles de l'expression spécifiée.
StDevP	Retourne l'écart-type de population de toutes les valeurs non nulles de l'expression spécifiée.
Sum	Retourne la somme des valeurs de l'expression spécifiée.
Var	Retourne la variance de toutes les valeurs non nulles de l'expression spécifiée.
VarP	Retourne la variance de population de toutes les valeurs non nulles de l'expression spécifiée.

Agrégations cumulées

Le tableau suivant décrit les fonctions d'agrégation cumulée dont vous disposez.

Fonction	Description
RowNumber	Retourne le cumul de toutes les lignes de l'étendue spécifiée.
RunningValue	Utilise une fonction spécifiée pour retourner un agrégat cumulé de l'expression spécifiée.

Agrégations personnalisées

Le tableau décrit la fonction d'agrégation personnalisée.

Fonction	Description
Aggregate	Retourne une agrégation personnalisée de l'expression spécifiée, telle que définie par le fournisseur de données.

Scope

Chaque fonction d'agrégation utilise le paramètre Scope, qui définit l'étendue dans laquelle la fonction est exécutée. Une étendue valide peut être le nom d'un regroupement, d'un dataset ou d'une région de données. Seuls les regroupements ou régions de données contenant directement ou indirectement l'expression peuvent être utilisés en guise d'étendue. Pour les expressions situées dans une région de données, le paramètre Scope est facultatif pour toutes les fonctions d'agrégation. Si vous omettez le paramètre Scope, l'étendue de l'agrégation correspond à la région de données ou au regroupement le plus à l'intérieur auquel appartient l'élément de rapport. Si vous spécifiez l'étendue Nothing, l'étendue est la région de données la plus à l'extérieur à laquelle appartient l'élément.

Pour les expressions à l'extérieur de régions de données, Scope se réfère à une table de données ou un objet d'entreprise. Si un rapport contient plusieurs datasets, le paramètre Scope est obligatoire. S'il ne contient qu'un dataset et que le paramètre Scope est omis, le dataset est défini comme l'étendue. Vous ne pouvez pas spécifier le mot clé Nothing pour les éléments de rapport situés à l'extérieur d'une région de données.

Vous ne pouvez pas utiliser le paramètre Scope dans les en-têtes et les pieds de page.

Voir aussi

Concepts

Création de sources de données pour un rapport
Utilisation d'expressions dans un rapport (Concepteur de rapports Visual Studio)
Contrôles ReportViewer (Visual Studio)
Vue d'ensemble des rapports (Visual Studio)