Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Retourne la première valeur dans l'étendue donnée de l'expression spécifié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
First(expression, scope)
Paramètres
expression
(Variant ou Binary) Expression sur laquelle effectuer l’agrégation, par exemple =Fields!FieldName.Value.
étendue
(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 le paramètre scope n'est pas spécifié, l'étendue actuelle est utilisée.
Type renvoyé
Déterminé par le type d'expression.
Remarques
La First fonction retourne la première valeur d’un jeu de données après l’application de tous les tris et filtrages au niveau de l’étendue spécifiée.
La fonction First ne peut pas être utilisée dans les expressions de filtre de groupe avec autre chose que la portée actuelle (par défaut).
Vous pouvez également utiliser First dans un en-tête de page pour renvoyer la première valeur de la ReportItems collection d’une page afin de produire des en-têtes de style dictionnaire qui affichent les premières et dernières entrées d’une page.
La valeur de l’étendue doit être une constante de chaîne et ne peut pas être une expression. Pour les agrégats externes ou les agrégats qui ne spécifient pas d'autres agrégats, le paramètre scope doit faire référence à l'étendue actuelle ou à une étendue contenante. Pour les agrégats d'agrégats, les agrégats imbriqués peuvent spécifier une étendue enfant.
Expression peut contenir des appels aux fonctions d'agrégation imbriquées avec les exceptions et conditions suivantes :
Le paramètreScope 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ètreScope des agrégats imbriqués ne peut pas être le nom d'un dataset.
L’expression ne doit pas contenir
First,LastouPreviousRunningValueles fonctions.Expression ne doit pas contenir les agrégats imbriqués qui spécifient recursive.
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).
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")
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)