Fonction First (Générateur de rapports version 2.0)
Retourne la première valeur dans l'étendue donnée de l'expression spécifiée.
Syntaxe
First(expression, scope)
Paramètres
expression
(Variant ou Binary) Expression sur laquelle effectuer l'agrégation ; par exemple, =Fields!FieldName.Value. L'expression ne peut pas contenir de fonctions d'agrégation.scope
(String) Facultatif. Nom d'un dataset, d'un groupe ou d'une région de données qui contient les éléments de rapport auxquels appliquer la fonction d'agrégation. Si scope n'est pas spécifié, l'étendue actuelle est utilisée. 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 le type d'expression.
Notes
La fonction First retourne la première valeur d'un jeu de données après que l'étendue spécifiée a été correctement triée et filtrée.
La fonction First ne peut être utilisée dans les expressions de filtre de groupe qu'avec l'étendue actuelle (par défaut).
Vous pouvez également utiliser First dans un en-tête de page pour retourner la première valeur de la collection ReportItems pour une page afin de produire des en-têtes de type dictionnaire qui affichent la première et la dernière entrées d'une page.
La valeur de scope ne peut pas être une expression et doit faire référence à l'étendue actuelle ou à une étendue contenante.
Exemple
L'exemple de code ci-dessous retourne le premier numéro de produit du groupe Category d'une région de données :
=First(Fields!ProductNumber.Value, "Category")