Konfigurieren und Verwenden der ReportViewer-Symbolleiste

Artikel
07/31/2015

Sie können Eigenschaften im Eigenschaftenfenster oder im Code festlegen, um das ReportViewer-Steuerelement und die ReportViewer-Symbolleiste zu konfigurieren. Sie können bestimmte Befehle entfernen oder deaktivieren und Werte festlegen, die zur Initialisierung der Symbolleiste verwendet werden. Weitere Informationen zu den Eigenschaften des ReportViewer-Webserversteuerelements finden Sie unter Microsoft.Reporting.WebForms.ReportViewer Properties. Weitere Informationen zu den Eigenschaften des Windows Forms-Steuerelements finden Sie unter Microsoft.Reporting.WinForms.ReportViewer Properties.

ReportViewer-Symbolleiste

Das ReportViewer-Steuerelement enthält eine Symbolleiste, von der Funktionen zum Navigieren, Suchen, Exportieren und Drucken bereitgestellt werden, sodass die Benutzer mit Berichten in einer bereitgestellten Anwendung arbeiten können. Sie können zur Entwurfszeit Eigenschaften für die Symbolleiste festlegen, um ihre Darstellung zu steuern und die Verfügbarkeit von Laufzeitoptionen festzulegen. Wenn Sie eine andere Symbolleistenimplementierung benötigen, können Sie eine benutzerdefinierte Symbolleiste erstellen und die Standardsymbolleiste durch diese ersetzen.

ReportViewerToolbar

Hinweis

Aufgrund von Unterschieden beim Rendering der Benutzeroberflächenelemente im HTML- und GDI-Format (Graphics Design Instrumentation) kann die Berichtssymbolleiste variieren, je nachdem, ob Sie das Webserversteuerelement oder das Windows Forms-Steuerelement verwenden.

Dokumentstrukturen

Eine Dokumentstruktur ist ein Navigationsbereich, der eine Liste mit Links enthält, auf die Benutzer klicken können, um zu einem bestimmten Bereich des Berichts zu gelangen. Die Dokumentstruktur ist ein reduzierbares geteiltes Feld links vom Berichtsanzeigebereich (oder rechts in Umgebungen mit einer Ausrichtung von rechts nach links). Nicht alle Berichte verfügen über eine Dokumentstruktur. Sie müssen eine solche in der Berichtsdefinition definieren, wenn Sie sie im Berichts-Viewer anzeigen möchten.

Navigieren in einem Bericht

Die ReportViewer-Symbolleiste enthält eine Vielzahl von Seitennavigationsfunktionen. Die Benutzer können eine bestimmte Seite auswählen oder direkt zur ersten oder letzten Seite navigieren. Seiten werden durch in der Berichtsdefinition explizit definierte Seitenumbrüche festgelegt. Seitenumbrüche können auch automatisch berechnet, je nach verwendetem Berichtsausgabeformat.

Da das ASP.NET-ReportViewer-Steuerelement standardmäßig asynchrone Postbacks für die Interaktion nutzt, können Benutzer nur die Schaltfläche Zurück des Browsers verwenden, wenn Sie die InteractivityPostBackMode-Eigenschaft auf AlwaysSynchronous festlegen.

Zum Navigieren in Drillthroughberichten können die Benutzer die Schaltfläche Zurück zum übergeordneten Bericht auf der ReportViewer-Symbolleiste oder die Browserschaltfläche Zurück verwenden, wenn Sie die InteractivityPostBackMode-Eigenschaft entsprechend festlegen. Es empfiehlt sich jedoch, dass Sie beim Anwendungsentwurf nur eine Navigationsoption vorsehen, damit der Sitzungsstatus konsistent bleibt, wenn die Benutzer in Drillthroughberichten navigieren. Andernfalls kann bei der Navigation in Drillthroughberichten die Fehlermeldung angezeigt werden, dass "Zurück" ohne Drillthroughbericht aufgerufen wurde. Sie haben folgende Möglichkeiten, um die Benutzer auf eine Navigationsoption zu beschränken:

Verwenden des AlwaysAsynchronous-Modus und Festlegen von ShowBackButton auf true.
Verwenden des AlwaysSynchronous-Modus oder des SynchronousOnDrillthrough-Modus und Festlegen von ShowBackButton auf false. Dadurch werden die Benutzer auf die Schaltfläche Zurück des Browsers beschränkt. Beachten Sie, dass für diese Option die AJAX-Features des Webserversteuerelements nicht genutzt werden.

Beenden und Aktualisieren eines Berichts

Im Webserversteuerelement können die Benutzer im Auslastungsstatusindikator auf den Link Abbrechen klicken, um das Rendern des Berichts abzubrechen. Im Windows Forms-Steuerelement können die Benutzer auf die Schaltfläche Beenden auf der ReportViewer-Symbolleiste klicken, um das Rendern des Berichts abzubrechen. Die Benutzer können die Schaltfläche Aktualisieren verwenden, um das Berichtsrendering auszulösen.

Wenn die Benutzer für einen Serverbericht auf Aktualisieren klicken, verarbeitet der Berichtsserver den Bericht mit den jeweils aktuellen Daten erneut. Beachten Sie, dass die jeweils aktuellen Daten von den Richtlinien für Zwischenspeicherung und Snapshots abhängen, die für den Bericht festgelegt wurden.

Wenn die Benutzer für einen lokalen Bericht auf Aktualisieren klicken, kann das Verhalten anders sein. Weil lokal verarbeitete Berichte von Ihrer Anwendung bereitgestellte Daten verwenden, müssen Sie möglicherweise während des Aktualisierungsvorgangs die Datenquelle aktualisieren, indem Sie Code bereitstellen, der das ReportViewer.ReportRefresh-Ereignis verarbeitet. Wird dieses Ereignis für das Windows Forms-Steuerelement nicht verarbeitet, wird der Bericht beim Klicken auf Aktualisieren mit alten Daten in der Anwendung aktualisiert. Weitere Informationen zum ReportViewer.ReportRefresh-Ereignis für das Webserversteuerelement finden Sie unter ReportRefresh. Weitere Informationen zur Version für das Windows Forms-Steuerelement finden Sie unter ReportRefresh.

Drucken eines Berichts

Über die ReportViewer-Symbolleiste wird Druckunterstützung bereitgestellt. Die Druckunterstützung ist je nach Version des ReportViewer-Steuerelements unterschiedlich implementiert. Darüber hinaus bietet das Webserversteuerelement nur in Internet Explorer Druckunterstützung. Weitere Informationen finden Sie unter Drucken von Berichten aus ReportViewer.

Zoomen der Berichtsseite

Über die ReportViewer-Symbolleiste werden Standardfunktionen zum Zoomen bereitgestellt, sodass Sie den Bericht vergrößern oder verkleinern können. Das Webserversteuerelement bietet nur in Internet Explorer Zoomfunktionen.

Durchsuchen eines Berichts

Die ReportViewer-Symbolleiste enthält ein Suchfeld zum Suchen eines bestimmten Texts in einem Bericht. Zum Suchen von Inhalten im Bericht geben Sie einen Suchbegriff oder -ausdruck ein. Bei der Suche wird die Groß- und Kleinschreibung beachtet, und sie beginnt bei der gerade angezeigten Seite. Platzhalter und boolesche Suchoperatoren werden nicht unterstützt. Nur sichtbarer Inhalt wird in Suchvorgänge eingeschlossen. Wenn im Bericht Funktionen zum Ein-/Ausblenden verwendet werden, werden ausgeblendete Inhalte nicht durchsucht. Wenn Sie nach weiteren Vorkommen desselben Werts suchen möchten, klicken Sie auf Weiter.

Exportieren eines Berichts

Von der ReportViewer-Symbolleiste werden Exportformate bereitgestellt, sodass die Benutzer einen Bericht in einem unterstützten Format speichern können. Ein lokaler Bericht kann als Excel-, PDF- oder Word-Datei exportiert werden. Ein Serverbericht kann in jedes vom Berichtsserver unterstützte Format exportiert werden. Wenn Sie das Webserversteuerelement verwenden, können Sie die ExportContentDisposition-Eigenschaft für das Steuerelement festlegen, damit der exportierte Bericht direkt in Excel oder einem PDF-Viewer angezeigt und nicht nur als Datei gespeichert wird.

Ein und derselbe Bericht kann je nach gewähltem Renderingformat unterschiedlich dargestellt werden und andere Funktionen aufweisen. Berichte mit Links, Dokumentstrukturen und Lesezeichen funktionieren nach dem Speichern in einer Datei möglicherweise nicht mehr ordnungsgemäß. Je nach Ausrichtung der Elemente in einem Bericht kann das Berichtslayout in einem anderen Dateiformat eine andere Anzahl von Seiten oder zusätzliche weiße Flächen enthalten.