Definieren von Seitengröße und Seitenumbrüchen in einem Bericht (Visual Studio-Berichts-Designer)

Sie können die Seitengröße und Seitenumbrüche durch Angeben seitenbezogener Eigenschaften in der Berichtsdefinition steuern. Der von Ihnen verwendete Steuerelementtyp und das zum Anzeigen eines Berichts verwendete Exportformat können sich auf die Paginierung auswirken. Je nachdem, wie er angezeigt wird, wird ein Bericht unterschiedlich umbrochen. In der folgenden Liste ist das Paginierungsverhalten für verschiedene Szenarien zusammengefasst:

• Mit dem Windows Forms-Steuerelement wird ein Bericht standardmäßig im GDI-Format (Graphical Device Instrumentation) dargestellt. Bei diesem Ausgabeformat werden weiche Seitenumbrüche (oder logische Seitenumbrüche) verwendet, die zur Laufzeit berechnet werden.

• Mit den Webserver-Steuerelementen wird ein Bericht im HTML-Format dargestellt. Bei diesem Format werden zur Laufzeit berechnete weiche Seitenumbrüche (oder logische Seitenumbrüche) verwendet. HTML-Seiten werden auf Grundlage der Zeilen- und Spaltenanzahl berechnet, die für den Bericht zurückgegeben werden.

• Beim Excel-Ausgabeformat werden weiche Seitenumbrüche (oder logische Seitenumbrüche) verwendet, die zur Laufzeit berechnet werden. Excel-Seiten werden als Arbeitsblätter in derselben Arbeitsmappe berechnet. Wenn eine Arbeitsmappe vier Arbeitsblätter enthält, wird jedes Arbeitsblatt als eine Seite gewertet.

• Bei PDF- und Bildrenderingerweiterungen handelt es sich um seitenorientierte Formate. Aus diesem Grund können Sie Eigenschaften festlegen, um genau zu steuern, wie Seiten für im PDF- oder Image (TIFF)-Format angezeigte Berichte umbrochen werden.

Die HTML- und Excel-Ausgabeformate orientieren sich nicht an realen Seiten. Weiterhin können die HTML-Berichte interaktiv sein. Dies bedeutet, dass Benutzeraktionen in einem Bericht zusätzliche Verarbeitungsschritte auslösen können, wodurch der Bericht horizontal oder vertikal erweitert wird, um zusätzliche Inhalte unterzubringen. Sie können nicht genau steuern, wie in diesem Format angezeigte Berichte umbrochen werden, wenn der Bericht interaktive Features enthält.

Verwenden von Seitenumbrüchen zum Verbessern der Berichtsverarbeitungsleistung

Sie können die Leistung großer Berichte beim Rendern und Anzeigen mithilfe von Seitenumbrüchen verbessern. Je nachdem, wie der Bericht angezeigt wird und ob das Steuerelement für asynchrone Verarbeitung konfiguriert ist, wird eine Berichtsseite vom Steuerelement im Viewer angezeigt, während die restlichen Seiten im Hintergrund gerendert werden. So kann ein Benutzer, bevor alle Seiten verfügbar sind, schon einmal die ersten Seiten des Bericht anzeigen.

Bei der HTML- und Excel-Ausgabe wird ein Bericht als einzelne Seite angezeigt, wenn keine Seitenumbrüche vorhanden sind. Wenn Sie InteractiveHeight und InteractiveWidth angeben, werden Berichte in den HTML- und Excel-Ausgabeformaten mithilfe von weichen Seitenumbrüchen gerendert. Weiche Seitenumbrüche werden anhand der geschätzten Seitengröße auf einer Seite platziert. Dadurch ist die Größe der Berichte weniger genau als bei Berichten, die in einem Ausgabeformat mit Seitengrößenunterstützung erstellt werden. Weiche Seitenumbrüche werden zur Laufzeit vom Steuerelement berechnet. Es ist zwar nicht empfehlenswert, aber Sie können weiche Seitenumbrüche durch Festlegen von InteractiveHeight auf 0 deaktivieren.

Angeben von Seitenumbrüchen und Seitengrößen

Seitenumbrüche bestimmen, wie Inhalte in eine Berichtsseite eingepasst werden. Sie können Seitenumbrüche vor oder nach Berichtselementen festlegen, indem Sie Eigenschaften für die betreffenden Elemente festlegen.

Sie können Seitenumbrüche am Anfang oder Ende eines Rechtecks bzw. einer Tabelle, Matrix, Liste, Grafik oder Gruppe hinzufügen. Standardmäßig weisen Berichtselemente keine Seitenumbrüche auf. Ändern Sie die Eigenschaft PageBreakAtEnd oder PageBreakAtStart für ein Element, um einen Seitenumbruch am Anfang oder am Ende eines Elements hinzuzufügen.

Seitenumbrüche erfolgen auch automatisch bei seitenorientierten Renderingerweiterungen (beispielsweise PDF und Image), von denen eine einheitliche Seitengröße im gesamten Bericht erzwungen wird. Die folgenden Eigenschaften werden verwendet, um Seitenumbrüche auf Grundlage der Seitengröße anzugeben:

• Die Eigenschaften PageHeight und PageWidth werden von den PDF- und Bildrenderingerweiterungen verwendet, um regelmäßige Seitenumbrüche auf Basis einer physischen Messung festzulegen.

• InteractiveHeight und InteractiveWidth werden von der HTML-Renderingerweiterung als Entsprechungen zu PageHeight und PageWidth verwendet. Weil die Größe eines Berichts im HTML-Ausgabeformat dynamisch angepasst wird, um das Drilldownfeature, das Drillthroughfeature und die Features zum Ein-/Ausblenden zu berücksichtigen, werden vom Berichtsserver verschiedene Eigenschaften zur Unterstützung der Paginierung dynamischer Seiten verwendet.

Hinweis

Die Berichtsbreite kann größer als die Seitenbreite sein. Wenn ein Bericht, der breiter als die angegebene Seitenbreite ist, von einer die Seitengröße unterstützenden Renderingerweiterung gerendert wurde, kann sich der resultierende Bericht möglicherweise horizontal über mehrere Seiten erstrecken. Wenn Sie einen Bericht so entworfen haben, dass er eine Seite breit ist, er aber über mehrere Seiten gerendert wird, stellen Sie sicher, dass die Breite des Berichts nicht größer als die Seitenbreite ist.

Weitere Information zum Festlegen von Seitengröße und Seitenumbrüchen finden Sie unter Gewusst wie: Festlegen von Seitenumbrüchen (Visual Studio-Berichts-Designer).

Siehe auch

Konzepte

Konfigurieren von ReportViewer für asynchrones Rendering
Hinzufügen von Kopfzeilen und Fußzeilen zu einem Bericht (Visual Studio-Berichts-Designer)