Boîte de dialogue Expression (Concepteur de rapports Visual Studio)

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é.

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 Understanding Simple and Complex Expressions (Reporting Services) dans la documentation en ligne de SQL Server.

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 Understanding Expressions in Reporting Services dans la documentation en ligne de SQL Server.

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 contextuelle ; les éléments de catégorie et les descriptions changent en fonction de la catégorie d'expression que vous utilisez. 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 How to: Add an Expression, Expression Examples in Reporting Services et Using Parameters in Expressions dans la documentation en ligne de SQL Server.

Constructions d'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 CLR (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 couleurs 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 Using Global Collections in Expressions dans la documentation en ligne de SQL Server.

• Paramètres
  Fournit une liste de 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 Using Report and Group Variables Collections References in Expressions (Reporting Services) dans la documentation en ligne de SQL Server.

• Opérateurs
  Affiche les opérateurs que vous pouvez inclure dans un calcul ou une manipulation de chaînes. Pour plus d'informations, consultez Using Operators in Expressions (Reporting Services) dans la documentation en ligne de SQL Server.

• 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 CLR (Common Language Runtime) .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 Using External Functions and Assemblies in Expressions dans la documentation en ligne de SQL Server.

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

Autres ressources

Référence de l'interface utilisateur du Concepteur de rapports (Visual Studio)