Boîte de dialogue Expression
Utilisez la boîte de dialogue Expression pour écrire des expressions Microsoft Visual Basic pour les propriétés d’élément de rapport. Vous pouvez utiliser des expressions pour définir un grand nombre de propriétés, notamment la couleur, la police et les bordures. Au moment de l'exécution, le processeur de rapports évalue les expressions et remplace le résultat de la valeur de la propriété.
Une expression peut être simple ou complexe. Vous pouvez taper des expressions simples directement dans une zone de texte sur l'aire de conception ou dans une boîte de dialogue. Pour créer des expressions complexes, utilisez la boîte de dialogue Expression . Vous ne pouvez créer qu'une seule expression à la fois. Pour plus d’informations, consultez Expressions (Générateur de rapports et SSRS).
Pour ouvrir la boîte de dialogue Expression , cliquez sur le bouton Expression (fx) dans les boîtes de dialogue, ou sélectionnez Expression dans le menu contextuel ou les listes déroulantes du volet Propriétés. Pour plus d’informations, consultez Utilisations des expressions dans les rapports (Report Builder et SSRS).
La boîte de dialogue Expression contient une fenêtre de code, une arborescence des catégories, des éléments de catégorie, un volet de description et un volet d’exemple.
La boîte de dialogue Expression est contextuelle : les éléments de catégorie et les descriptions changent en fonction de la catégorie d’expression sur laquelle vous travaillez. Elle prend en charge IntelliSense, la saisie semi-automatique des instructions, les exemples d'appels de fonction et les couleurs de la syntaxe pour vous aider à détecter les erreurs de syntaxe.
Composants d'une expression
Les expressions commencent par un signe égal (=) et peuvent inclure des constantes, des littéraux, des opérateurs et des références à des champs intégrés, des collections intégrées, des fonctions intégrées, des fonctions de bibliothèque d’exécution Visual Basic, des classes common language runtime .NET Framework et des fonctions personnalisées. La liste suivante décrit les catégories et les valeurs que vous pouvez ajouter à une expression.
Définir l’expression pour:<PropertyName>
Nom de la propriété pour laquelle vous définissez une expression. Vous pouvez également définir cette propriété, par son nom, dans le volet Propriétés.
Constantes
Fournit la liste des valeurs prédéfinies valides pour cette propriété pour les propriétés basées sur des constantes. Par exemple, une propriété basée sur la couleur affiche les noms de couleur valides. Pour une propriété qui est un type de données Booléen, les valeurs sont True et False.
Une constante ne peut pas être affectée à tous les éléments qui prennent en charge les expressions. Si une valeur constante ne peut pas être affectée à une propriété, le volet de description l'indique.
Champs prédéfinis
Donne la liste des éléments de la collection globale que vous pouvez utiliser dans une expression. Certaines collections ne sont prises en charge qu'après la publication du rapport sur le serveur. Pour plus d’informations, consultez Références à des champs Globals et Users prédéfinis (Générateur de rapports et SSRS).
Paramètres
Fournit la liste des paramètres de rapport.
Champs(<jeu de données> sélectionné)
Affiche la liste des champs du dataset sélectionné dans la catégorie Datasets. Double-cliquez sur un champ pour le copier dans la zone Expression .
Groupes de données
Donne la liste des datasets disponibles et affiche les champs membres du dataset.
Variables
Affiche la liste des variables de rapport. Pour plus d’informations, consultez Références à des collections de variables de rapport et de groupe (Générateur de rapports et SSRS).
Opérateurs
Affiche les opérateurs que vous pouvez inclure dans un calcul ou une manipulation de chaîne. Pour plus d’informations, consultez Opérateurs dans les expressions (Report Builder et SSRS).
Fonctions courantes
Affiche des fonctions communes, regroupées par type. Lorsque vous sélectionnez une fonction dans le volet Élément, une description et un exemple s'affichent.
Les fonctions courantes incluent les fonctions intégrées de rapport et d’agrégation, les fonctions de bibliothèque d’exécution Visual Basic et les classes CLR (Common Language Runtime) .NET Framework dans l’espace de Math noms et Convert . Vous pouvez également ajouter des références à des classes CLR et à des assemblys externes qui n'apparaissent pas dans la liste des catégories. Pour plus d’informations, consultez Code personnalisé et références d’assembly dans les expressions du Concepteur de rapports (SSRS).
Options
Fenêtre de code
Utilisez la fenêtre de code du volet supérieur pour taper une expression. Quand vous ouvrez la boîte de dialogue Expression , la fenêtre de code contient l’expression. Vous pouvez remplacer ou modifier l'expression. Vous pouvez ajouter des appels de fonction, des opérateurs, des constantes, des champs, des paramètres, des éléments issus des collections globales et des références à du code personnalisé. La fenêtre de code affiche vos modifications à mesure que vous les apportez.
Un soulignement ondulé rouge signale une erreur de syntaxe. Pointez sur le texte souligné pour afficher le message d'erreur.
Lorsque vous entrez des termes de collections globales suivis d'un signe de ponctuation, une liste déroulante affiche les membres ou propriétés disponibles. Dans la liste déroulante, vous pouvez taper les tout premiers caractères suivis d'une tabulation pour remplir automatiquement la sélection.
Lorsque vous tapez un nom de fonction suivi d'une parenthèse ouvrante, une info-bulle qui fournit des informations sur les paramètres et les valeurs de retour de fonction s'affiche.
Catégorie
Affiche les catégories d'expressions. Le choix d'une catégorie établit un contexte pour la création d'une expression et modifie la liste des valeurs valides dans le volet Élément. Par exemple, pour une expression pour une valeur de zone de texte, développez Fonctions communes et sélectionnez Fonctions d’agrégation pour afficher Avg, Countet d’autres fonctions dans le volet Élément .
Item
Affiche la liste des valeurs valides pour la catégorie sélectionnée. Double-cliquez sur un élément pour ajouter le texte de l'expression pour cet élément au point d'insertion dans la fenêtre de code.
Valeurs
En fonction de la catégorie et de l'élément sélectionnés, le troisième volet contient une description, un exemple d'expression ou la liste des valeurs valides. Faites glisser le bord de la boîte de dialogue pour élargir la zone d'aperçu.
Voir aussi
Expressions (Générateur de rapports et SSRS)
Exemples d'expressions (Générateur de rapports et SSRS)
Utilisation d'expressions dans les rapports (Générateur de rapport et SSRS)
Mise en forme des nombres et des dates (Générateur de rapports et SSRS)
Références à la collection Parameters (Générateur de rapports et SSRS)
Exemples d'expressions de groupe (Générateur de rapports et SSRS)
Exemples d'équations de filtre (Générateur de rapports et SSRS)
Types de données dans les expressions (Générateur de rapports et SSRS)
Collections intégrées dans les expressions (Générateur de rapports et SSRS)
Ajouter une expression (Générateur de rapports et SSRS)