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'un é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 version 3.0 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 Utilisation d'expressions (Générateur de rapports version 3.0 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 sensible au contexte ; 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, ainsi que des références à des champs prédéfinis, à des collections intégrées, à des fonctions intégrées, à des fonctions de la bibliothèque d'exécutables Visual Basic, à des classes Common Language Runtime (CLR) .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 Utilisation de références à des champs Globals et Users prédéfinis (Report Builder 3.0 et SSRS).Paramètres
Fournit la liste des paramètres de rapport.Champs(<selected Dataset>)
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.Datasets
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 Utilisation de références à des collections de variables de rapport et de groupe (Générateur de rapports version 3.0 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 Utilisation d'opérateurs dans des expressions (Générateur de rapports version 3.0 et SSRS).Fonctions communes
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 communes incluent les fonctions de rapport et d'agrégation intégrées, les fonctions de la bibliothèque d'exécutables Visual Basic et les classes Common Language Rruntime (CLR) .NET Framework de l'espace de noms Math 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 dans le Concepteur de rapports (SSRS).
Options
Fenêtre de code
Utilisez la fenêtre de code du volet supérieur pour taper une expression. Lors de l'ouverture de 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 destinée à générer une valeur de zone de texte, développez Fonctions communes, puis sélectionnez Fonctions d'agrégation pour afficher Avg, Count et d'autres fonctions dans le volet Élément.Élément
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