Ajout d'images à un rapport (Concepteur de rapports Visual Studio)

Une image est un élément de rapport qui contient une référence à une image qui est stockée sur le serveur de rapports, incorporée dans le rapport ou enregistrée dans une base de données. Une image peut être un logo ou une image apparaissant une fois sur le rapport, ou encore une image répétée avec des lignes de données. Vous pouvez également utiliser une image en guise d'arrière-plan pour certains éléments de rapport. Vous pouvez obtenir des images des sources suivantes :

• Base de données

• Partage de fichiers externe ou site Web

• Incorporées localement dans le rapport

Vous ne pouvez pas utiliser des fichiers image qui ont été ajoutés à un projet.

Des images liées aux données peuvent également être affichées à partir de données binaires stockées dans une base de données. Par exemple, les images qui jouxtent les noms de produits dans une liste de produits sont des images de base de données.

Les images externes sont spécifiées sous la forme d'une URL pointant vers un fichier image. Les images externes sont parfaitement adaptées aux logos et images statiques partagées par plusieurs rapports ou pages Web.

Les images de rapport locales sont incorporées dans le rapport, puis référencées. Les données de type image sont stockées dans la définition de rapport et n'existent pas en tant que fichier séparé. En revanche, il est préférable de recourir à des images incorporées pour vous assurer qu'elles sont disponibles en permanence pour le rapport. Cependant, elles ne peuvent pas être partagées. L'incorporation d'une image augmente la taille du fichier de définition de rapport. Lorsque vous incorporez une image, le Concepteur de rapports lui applique un codage MIME, puis la stocke en tant que texte dans la définition de rapport.

Comment ajouter une image incorporée à un rapport

1. Ouvrez le fichier de définition de rapport client (.rdlc) en mode de conception graphique.

2. Dans le menu Rapport, sélectionnez Images incorporées, puis ajoutez toutes les images que vous souhaitez utiliser dans le rapport. Si le menu Rapport n'est pas visible, cliquez dans la zone de conception du rapport.

3. Faites glisser le contrôle image de la boîte à outils à la mise en page du rapport. Vous devez utiliser le contrôle image employé pour les rapports ReportViewer.

4. Sélectionnez l'image, puis ouvrez la fenêtre Propriétés dans Visual Studio.

5. Attribuez à Source la valeur Embedded.

6. Pour Valeur choisissez une image qui est incorporée dans la définition de rapport. Vous pouvez effectuer ce choix dans une liste déroulante.

Utilisation d'une image externe ou de bases de données dans un rapport

Pour utiliser une image de base de données, vous pouvez spécifier le champ de base de données qui contient l'image à condition que le type MIME soit JPG, PNG ou BMP. Si l'image est stockée en tant qu'objet binaire, vous devez écrire une expression qui convertit l'image dans le type pris en charge.

L'utilisation d'images externes dans un rapport ReportViewer n'est pas activée par défaut. Pour utiliser une image externe, vous devez définir la propriété EnableExternalImages dans votre code. En fonction de la configuration de votre réseau, vous devez éventuellement aussi ignorer des paramètres proxy pour permettre l'affichage de l'image externe. Vous pouvez ajouter les paramètres suivants au fichier Web.config pour ignorer le proxy local. Lors de la modification de votre fichier Web.config, veillez à spécifier le nom du serveur proxy utilisé dans votre réseau :

<system.net>

<defaultProxy>

<proxy usesystemdefault = "false"

bypassonlocal = "true"

proxyaddress = "http://<nomserveurproxy>:80/" />

<defaultProxy>

</system.net>

Images d'arrière-plan

Vous pouvez utiliser une image comme arrière-plan dans le corps du rapport ou dans un rectangle, une zone de texte, une liste, une matrice ou une table. Une image d'arrière-plan possède les mêmes propriétés qu'une image. Vous pouvez également indiquer la manière dont l'image est reproduite pour occuper tout l'arrière-plan de l'élément.

Remarque

Si vous définissez une image d'arrière-plan pour le corps du rapport, mais pas pour l'en-tête ou le pied de page, les rapports HTML utiliseront automatiquement la même image d'arrière-plan dans les trois régions du rapport. Si vous ne voulez pas utiliser d'image d'arrière-plan dans l'en-tête ou le pied de page, vous devez explicitement définir une image différente pour ces régions. Si vous ne voulez pas que ces régions comportent une image, vous pouvez créer et affecter une image transparente de petite taille à l'en-tête ou au pied de page afin de donner l'impression qu'il n'y a aucune image.

Pour ajouter une image d'arrière-plan, procédez comme suit :

1. Ouvrez le fichier de définition de rapport client (.rdlc) en mode de conception graphique.

2. Sélectionnez l'élément de rapport auquel ajouter une image d'arrière-plan.

   Remarque
   Les images d'arrière-plan s'appliquent uniquement aux éléments de type rectangle, zone de texte, tableau, matrice, liste ou corps de rapport.

3. Dans la fenêtre Propriétés, développez BackgroundImage, puis procédez comme suit :

   • Pour Source, sélectionnez External, Embedded ou Database.

     Remarque
     Pour utiliser une image du projet, sélectionnez External.

   • Pour Value, tapez ou sélectionnez une expression qui correspond à la source de l'image.

     Si la propriété Source prend la valeur External, l'expression doit correspondre à un chemin d'accès valide à une image. Il peut s'agir d'un chemin statique d'accès à une image hébergée sur un serveur de rapports ou bien, d'un chemin d'accès basé sur la valeur d'un champ. Si l'image est stockée dans le projet, tapez son nom tel qu'il apparaît dans le projet.

     Si la propriété Source prend la valeur Embedded, l'expression doit correspondre au nom d'une image incorporée dans le rapport. Si la propriété Source prend la valeur Database, l'expression doit correspondre à un champ contenant des données image binaires.

   • Pour MIMEType, sélectionnez le type MIME approprié pour l'image.

     Remarque
     MIMEType s'applique uniquement si la propriété Source prend la valeur Database. Si la propriété Source prend la valeur External ou Embedded, la valeur de MIMEType est ignorée.

Pour BackgroundRepeat, sélectionnez Repeat, NoRepeat, RepeatX ou RepeatY.

Voir aussi

Concepts

Ajout de rectangles, de lignes et de bordures à un rapport (Concepteur de rapports Visual Studio)
Création de sources de données pour un rapport
Ajout de régions de données à un rapport (Concepteur de rapports Visual Studio)
Ajout d'interactivité, de visibilité et de navigation à un rapport (Concepteur de rapports Visual Studio)
Définition d'une mise en page de rapport (Concepteur de rapports Visual Studio)