Hinzufügen von Bildern zu einem Bericht (Visual Studio-Berichts-Designer)

Ein Bild ist ein Berichtselement, das einen Verweis auf ein Bild enthält, das auf einem Berichtsserver gespeichert, im Bericht eingebettet oder in einer Datenbank gespeichert ist. Ein Bild kann ein Logo oder eine Grafik sein, das bzw. die einmal im Bericht angezeigt wird, aber auch ein Bild, das mit Datenzeilen wiederholt wird. Sie können ein Bild auch als Hintergrund für bestimmte Berichtselemente verwenden. Sie können Bilder von den folgenden Datenquellen abrufen:

• Datenbank

• Externe Dateifreigabe oder Website

• Lokal eingebettet im Bericht

Sie können keine Bilddateien verwenden, die einem Projekt hinzugefügt wurden.

Datengebundene Bilder können auf der Grundlage von Binärdaten angezeigt werden, die in einer Datenbank gespeichert sind. Datenbankbilder sind beispielsweise jene Bilder, die neben Produktnamen in einer Produktliste angezeigt werden.

Externe Bilder werden als URL angegeben, die auf eine Bilddatei zeigt. Externe Bilder eignen sich gut für Logos und statische Bilder, die von mehreren Berichten oder Webseiten gemeinsam verwendet werden.

Lokale Berichtbilder werden in den Bericht eingebettet. Anschließend wird auf sie verwiesen. Die Bilddaten werden innerhalb der Berichtsdefinition gespeichert; sie sind also nicht als separate Datei vorhanden. Mit eingebetteten Bildern wird sichergestellt, dass die Bilder jederzeit für den Bericht verfügbar sind. Sie können allerdings nicht gemeinsam genutzt werden. Durch das Einbetten eines Bilds wird die Berichtsdefinitionsdatei größer. Wenn Sie ein Bild einbetten, wird das Bild vom Berichts-Designer MIME-codiert und dann als Text in der Berichtsdefinition gespeichert.

Hinzufügen eines eingebetteten Bilds zu einem Bericht

1. Öffnen Sie die Client-Berichtsdefinitionsdatei (RDLC) im grafischen Entwurfsmodus.

2. Wählen Sie im Menü Bericht die Option Eingebettete Bilder aus, und fügen Sie alle Bilder hinzu, die Sie im Bericht verwenden möchten. Wenn das Menü Bericht nicht angezeigt wird, müssen Sie innerhalb des Berichtsentwurfsbereichs klicken.

3. Ziehen Sie das Bildsteuerelement aus der Toolbox auf das Berichtslayout. Sie müssen das Bildsteuerelement verwenden, das für ReportViewer-Berichte verwendet wird.

4. Wählen Sie das Bild aus, und öffnen Sie dann das Fenster Eigenschaften in Visual Studio.

5. Legen Sie für Source die Einstellung Embedded fest.

6. Legen Sie für Value ein Bild fest, das in die Berichtsdefinition eingebettet ist. Sie können das zu verwendende Bild aus einer Dropdownliste auswählen.

Verwenden eines externen Bilds oder eines Datenbankbilds in einem Bericht

Zum Verwenden eines Datenbankbilds können Sie das Datenbankfeld angeben, das das Bild enthält, sofern der MIME-Typ JPG, PNG oder BMP ist. Wenn das Bild als binäres Objekt gespeichert ist, müssen Sie einen Ausdruck schreiben, der das Bild in einen unterstützten Typ konvertiert.

Die Verwendung externer Bilder in einem ReportViewer-Bericht ist nicht standardmäßig aktiviert. Zum Verwenden eines externen Bilds müssen Sie die EnableExternalImages-Eigenschaft im Code festlegen. Je nach Netzwerkkonfiguration müssen möglicherweise auch Proxyeinstellungen umgangen werden, damit das externe Bild angezeigt werden kann. Sie können der Datei Web.config die folgenden Einstellungen hinzufügen, um den lokalen Proxy zu umgehen. Wenn Sie Web.config ändern, müssen Sie den Namen des Proxyservers angeben, der in Ihrem Netzwerk verwendet wird.

<system.net>

<defaultProxy>

<proxy usesystemdefault = "false"

bypassonlocal = "true"

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

<defaultProxy>

</system.net>

Hintergrundbilder

Sie können ein Bild als Hintergrund im Hauptteil des Berichts oder in einem Rechteck oder Textfeld, einer Liste, Matrix oder Tabelle verwenden. Ein Hintergrundbild hat dieselben Eigenschaften wie ein Bild. Sie können auch angeben, wie das Bild zum Ausfüllen des Elementhintergrunds wiederholt wird.

Hinweis

Wenn Sie ein Hintergrundbild für den Hauptteil des Berichts definieren, jedoch nicht für den Seitenkopf oder -fuß, verwenden HTML-Berichte automatisch das gleiche Hintergrundbild für alle drei Bereiche des Berichts. Wenn Sie das Hintergrundbild nicht in der Kopf- oder Fußzeile verwenden möchten, müssen Sie für diese Bereiche explizit ein anderes Bild definieren. Wenn in diesen Bereichen kein Bild angezeigt werden soll, können Sie ein kleines, transparentes Bild erstellen und der Kopf- bzw. Fußzeile zuordnen.

Führen Sie folgende Aktionen aus, um ein Hintergrundbild hinzuzufügen:

1. Öffnen Sie die Client-Berichtsdefinitionsdatei (RDLC) im grafischen Entwurfsmodus.

2. Wählen Sie das Berichtselement aus, dem Sie ein Hintergrundbild hinzufügen möchten.

   Hinweis
   Hintergrundbilder können nur auf Rechtecke, Textfelder, Tabellen, Matrizen, Listen oder Hauptteile von Berichten angewendet werden.

3. Erweitern Sie BackgroundImage im Fenster Eigenschaften, und führen Sie die folgenden Aktionen aus:

   • Wählen Sie für Source den Wert External, Embedded oder Database aus.

     Hinweis
     Wenn Sie ein Bild aus dem Projekt verwenden möchten, wählen Sie External aus.

   • Geben Sie für Value einen Ausdruck ein, der zur Quelle des Bilds ausgewertet wird, oder wählen Sie ihn aus.

     Wenn für die Source-Eigenschaft External festgelegt ist, muss der Ausdruck zu einem gültigen Bildpfad ausgewertet werden. Dabei kann es sich um einen statischen Pfad zu einem Bild handeln, das sich auf einem Berichtsserver befindet, oder um einen Pfad, der auf einem Feld basiert. Ist das Bild im Projekt gespeichert, geben Sie den Namen des Bilds ein, der auch im Projekt verwendet wird.

     Wenn für die Source-Eigenschaft Embedded festgelegt ist, muss der Ausdruck zu dem Namen eines Bilds ausgewertet werden, das im Bericht eingebettet ist. Wenn für die Source-Eigenschaft Database festgelegt ist, muss der Ausdruck zu einem Feld ausgewertet werden, das binäre Bilddaten enthält.

   • Wählen Sie für MIMEType den entsprechenden MIME-Typ für das Bild aus.

     Hinweis
     MIMEType gilt nur dann, wenn für die Source-Eigenschaft die Einstellung Database festgelegt ist. Wenn für die Source-Eigenschaft External oder Embedded festgelegt ist, wird der Wert von MIMEType ignoriert.

Wählen Sie für BackgroundRepeat den Wert Repeat, NoRepeat, RepeatX oder RepeatY aus.

Siehe auch

Konzepte

Hinzufügen von Rechtecken, Linien und Rahmen zu einem Bericht (Visual Studio-Berichts-Designer)
Erstellen von Datenquellen für einen Bericht
Hinzufügen von Datenbereichen zu einem Bericht (Visual Studio-Berichts-Designer)
Hinzufügen von Features für Interaktivität, Sichtbarkeit und Navigation zu einem Bericht (Visual Studio-Berichts-Designer)
Definieren eines Berichtslayouts (Visual Studio-Berichts-Designer)