Artikel
09/24/2010

Rendern in das HTML-Format

Die HTML-Renderingerweiterung rendert einen Bericht im HTML-Format. Die Renderingerweiterung kann außerdem vollständige HTML-Seiten oder HTML-Fragmente zum Einbetten in andere HTML-Seiten erstellen. HTML wird stets mit UTF-8-Codierung erstellt.

Die HTML-Renderingerweiterung ist die Standardrenderingerweiterung für Berichte, die mit einem Browser angezeigt werden, und zwar auch bei Ausführung im Berichts-Manager. Die HTML-Renderingerweiterung kann HTML als Fragment oder als vollständiges HTML-Dokument rendern. Falls HTML ein Fragment ist, werden die Tags HEAD, HTML und BODY des HTML-Dokuments entfernt. Nur der Inhalt des BODY-Tags wird gerendert. Dies ist hilfreich beim Einbetten des HTML-Codes in den von einer anderen Anwendung erstellten HTML-Code.

Sicherheitshinweis
Wenn Sie innerhalb des Berichts einen Parameter vom Typ String definieren, wird den Benutzern ein Textfeld angezeigt, das jeden beliebigen Wert annehmen kann. Wenn ein Berichtsparameter nicht an einen Abfrageparameter gebunden ist und die Parameterwerte im Bericht enthalten sind, hat ein Benutzer die Möglichkeit, Ausdruckssyntax, Skript oder eine URL in den Parameterwert einzugeben und den Bericht als HTML zu rendern. Zeigt ein anderer Benutzer den Bericht an und klickt auf den gerenderten Parameterinhalt, führt der Benutzer möglicherweise versehentlich das bösartige Skript bzw. den Link aus. Um das Risiko der versehentlichen Ausführung bösartiger Skripts zu minimieren, sollten gerenderte Berichte nur von vertrauenswürdigen Quellen geöffnet werden. Weitere Informationen zum Sichern von Berichten finden Sie unter Sichern von Berichten und Ressourcen.

Wenn Sie innerhalb des Berichts einen Parameter vom Typ String definieren, wird den Benutzern ein Textfeld angezeigt, das jeden beliebigen Wert annehmen kann. Wenn ein Berichtsparameter nicht an einen Abfrageparameter gebunden ist und die Parameterwerte im Bericht enthalten sind, hat ein Benutzer die Möglichkeit, Ausdruckssyntax, Skript oder eine URL in den Parameterwert einzugeben und den Bericht als HTML zu rendern. Zeigt ein anderer Benutzer den Bericht an und klickt auf den gerenderten Parameterinhalt, führt der Benutzer möglicherweise versehentlich das bösartige Skript bzw. den Link aus.

Um das Risiko der versehentlichen Ausführung bösartiger Skripts zu minimieren, sollten gerenderte Berichte nur von vertrauenswürdigen Quellen geöffnet werden. Weitere Informationen zum Sichern von Berichten finden Sie unter Sichern von Berichten und Ressourcen.

Weitere Informationen zu Browsern und Berichtsrendering finden Sie unter Planen der Browserunterstützung und Exportieren von Berichten.

Rendern in das MHTML-Format

Die HTML-Renderingerweiterung kann Berichte im MHTML-Format (MIME Encapsulation of Aggregate HTML Documents) rendern. MHTML erweitert HTML, um codierte Objekte in das HTML-Dokument einzubetten, z. B. Bilder. Mit der MHTML-Renderingerweiterung können Sie Ressourcen wie Bilder, Dokumente oder andere Binärdateien als MIME-Strukturen (Multipurpose Internet Mail Extensions) in den Berichts-HTML-Code in einer einzelnen Datei einbetten. Daneben sind MHTML-Berichte zur Einbettung in E-Mail-Nachrichten geeignet, da alle Ressourcen in den Bericht eingeschlossen sind. Zwar rendert eigentlich die HTML-Renderingerweiterung MHTML, aber diese Funktion kann auch als MHTML-Renderingerweiterung bezeichnet werden.

Browserunterstützung

Diese Renderingerweiterung unterstützt die folgenden Browserversionen:

Internet Explorer 5.5 und höher
Firefox 1.5 und höher
Safari 3.0 und höher

Aufgrund von browserübergreifenden Überlegungen kann der gerenderte Bericht je nach Browser leicht unterschiedlich ausfallen. So enthält z. B. das Textfeld die Eigenschaft WritingMode. Diese Eigenschaft wird in Firefox nicht unterstützt.

HTML-spezifische Renderingregeln

Die folgenden HTML-spezifischen Regeln werden beim Rendern angewendet:

Der Renderer erstellt eine HTML-Tabellenstruktur mit allen Elementen in jeder ReportItems-Auflistung, falls mehr als eine vorhanden ist.
Jedes Element innerhalb der Tabellenstruktur nimmt eine einzelne Zelle ein.
Leere Zellen werden so weit wie möglich reduziert, um die Größe der HTML-Datei zu reduzieren.
Eine Reihe leerer Zellen wird dem oberen Rand und eine weitere Spalte dem linken Rand hinzugefügt, um die Geschwindigkeit, mit der Browser die Tabelle rendern können, zu erhöhen.
Tabellenzeilen oder -spalten, die keine Elemente, sondern nur Lücken zwischen Elementen enthalten, erhalten eine feste Breite und Höhe.
Allen anderen Zeilen und Spalten können abhängig von der Größe der einzelnen Berichtselemente zunehmen.
Alle Koordinaten und Berichtselementgrößen werden in Millimeter konvertiert. Alle anderen Größen, einschließlich der Stileigenschaften, behalten ihre ursprünglichen Einheiten bei. Größen- und Positionsunterschiede, die kleiner als 0,2 mm sind, werden als 0 mm behandelt.

Interaktivität

Einige interaktive Elemente werden in HTML unterstützt. Im Folgenden werden spezifische Funktionsweisen beschrieben.

Einblenden und Ausblenden

Ein Berichtselement, das ein- und ausgeblendet werden kann, wird mit einem Bild zum Umschalten (+/-) gerendert. Auf dieses Element kann geklickt werden. Wenn auf das Element geklickt wird, erfolgt ein Rückruf an den Server, um die Ausgabe mit dem geänderten aktuellen Ansichtsstatus erneut zu rendern.

Dokumentstruktur

Dokumentstrukturbezeichnungen werden gerendert und sind navigierbar. Verwenden Sie dazu die Dokumentstruktur im Steuerelement für den Viewer. Für ausgelassene Datenbereichskopfzeilen werden Bezeichnungen auf der ersten untergeordneten Zelle gerendert. Wenn keine untergeordnete Zelle vorhanden ist, wird die Bezeichnung auf dem untergeordneten Element gerendert, das ihm vorausgeht.

Lesezeichen

Lesezeichenlinks werden gerendert und als Links angezeigt. Lesezeichenziele werden gerendert. Die Navigation zu diesen Zielen erfolgt durch Klicken auf die Lesezeichenlinks. Beim Klicken auf einen Lesezeichenlink springt der Bericht zum ersten Auftreten der Ziellesezeichenbezeichnung, sofern möglich. Im Browser wird ein Bildlauf durchgeführt, sodass sich der Lesezeichenlink oben im Fenster befindet. HTML-Anchortags (<a>) werden verwendet, um Lesezeichenziele zu markieren.

Interaktives Sortieren

Bei einem Textfeld mit benutzerdefinierter Sortierung rendert die HTML-Renderingerweiterung die Sortiersymbole im Textfeld rechts vom Inhalt. Wenn ein Bericht ein Textfeld mit benutzerdefinierter Sortierung enthält, wird JavaScript gerendert, was zu einem Postback zum Server führt, wenn das Sortiersymbol angeklickt wird.

Hyperlinks und Drillthroughlinks

Hyperlinks und Drillthroughlinks werden in Berichtselementen als Hyperlinks gerendert. Dabei wird das HTML-Anchortag (<a>) um das Element verwendet, für das sie definiert sind.

Suchen

Das Suchfeature ermöglicht es Benutzern, nach einer Textzeichenfolge innerhalb des Berichts zu suchen.

Zusätzliche Suchfunktionen werden vom ReportViewer Web Forms-Steuerelement bereitgestellt.

Geräteinformationseinstellungen

Sie können einige Standardeinstellungen für diesen Renderer ändern, einschließlich des Modus für das Rendern. Ändern Sie dazu die Geräteinformationseinstellungen. Weitere Informationen finden Sie unter Geräteinformationseinstellungen in Reporting Services.