Boîte de dialogue Expression

Utilisez la boîte de dialogue Expression pour écrire des expressions MicrosoftVisual 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é.

Les expressions peuvent être simples ou complexes. 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. Pour plus d'informations, consultez Présentation des expressions simples et complexes (Reporting Services).

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 Présentation des expressions simples et complexes (Reporting Services).

Certaines boîtes de dialogue (par exemple, la Boîte de dialogue Propriétés du dataset, Filtres) vous permettent de créer plusieurs expressions qui sont combinées au cours du traitement du rapport, mais la boîte de dialogue Expression fonctionne avec une seule expression à la fois.

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.

Pour plus d'informations, consultez Procédure : ajouter une expression (Reporting Services), Exemples d'expressions (Reporting Services) et Utilisation de références à la collection Parameters dans des expressions (Reporting Services).

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 collections intégrées dans les expressions (Reporting Services).

  • 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 dans les expressions (Reporting Services).

  • 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 (Reporting Services).

  • 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 Utilisation de références à des fonctions communes et à des assemblys (Reporting Services).

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

Référence

Concepts

Autres ressources