Hinzufügen und Konfigurieren der ReportViewer-Steuerelemente

Artikel
05/06/2011

Sie können einer Windows Forms- oder einer ASP.NET-Anwendung eine oder mehrere Instanzen eines ReportViewer-Steuerelements hinzufügen, indem Sie das Steuerelement aus dem Bereich "Berichterstellung" der Toolbox auf eine Seite oder ein Formular in Ihrer Anwendung ziehen. Sie können einen Smarttagbereich und Smarttageigenschaften verwenden, um das Steuerelement zu konfigurieren und den Bericht zu binden. Außerdem können Sie Code schreiben, wenn Sie das Steuerelement programmgesteuert konfigurieren möchten.

Das ReportViewer-Steuerelement zeigt jeweils einen Bericht an. Sie können mehrere Instanzen des Steuerelements auf derselben Seite oder demselben Formular verwenden, um mehrere Berichte gleichzeitig anzuzeigen. Sie können auch eine einzelne Instanz des Steuerelements verwenden, um Berichte einzeln zu hosten. Um eine Sequenz von Berichten mithilfe eines einzigen Steuerelements anzuzeigen, müssen Sie Code schreiben, der der Instanz des ReportViewer-Steuerelements, die Sie verwenden möchten, einen Bericht zuordnet.

Die ReportViewer-Steuerelemente arbeiten entweder im lokalen Verarbeitungsmodus oder im Remoteverarbeitungsmodus.

Im lokalen Verarbeitungsmodus öffnet das Steuerelement eine Berichtsdefinition, verarbeitet sie und rendert den Bericht dann im Anzeigebereich. Im lokalen Verarbeitungsmodus können Sie die Berichtsdefinition aus einer RDLC-Datei im Dateisystem, von einem Datenstrom oder von einer eingebetteten Ressource in der Anwendung abrufen. Weitere Informationen finden Sie unter ReportPath, LoadReportDefinition und ReportEmbeddedResource.

Im Remoteverarbeitungsmodus ruft das Steuerelement einen vollständig verarbeiteten Bericht von einem Berichtsserver mit Reporting Services ab. Im Remoteverarbeitungsmodus erfolgt die Datenverarbeitung und Berichtsverarbeitung vollständig auf dem Berichtsserver. Der Remoteverarbeitungsmodus wird in der Regel für vorveröffentlichte Berichte verwendet, Sie können diesen Modus aber auch für Berichtsdefinitionen verwenden, die Sie mithilfe eines Streams hochladen. Weitere Informationen finden Sie unter LoadReportDefinition, ReportServerUrl und ReportPath.

Wichtig

Die Verwendung von RDLC-Dateien im Remoteverarbeitungsmodus ist nicht möglich. Für den Remoteverarbeitungsmodus ist eine lizenzierte Version von SQL Server 2008 Reporting Services (oder höher) erforderlich. Die Remoteverarbeitung ist zur Unterstützung von Organisationen konzipiert, die einen Berichtsserver mit SQL Server Reporting Services einsetzen und diesen Server zusammen mit den Steuerelementen verwenden möchten. Eine Serverlösung bietet eine höhere Skalierbarkeit und Leistung und stellt zusätzliche Funktionen zur Verfügung, z. B. Abonnements, Zwischenspeicherung und eine größere Anzahl von Ausgabeformaten für Berichte. Weitere Informationen zum Remoteverarbeitungsmodus finden Sie unter Konfigurieren von ReportViewer für die Remoteverarbeitung und Bereitstellen von Berichten und ReportViewer-Steuerelementen.

Hinzufügen und Konfigurieren eines ReportViewer-Steuerelements

Fügen Sie einem .NET Framework 3.5-Projekt oder 4.0-Projekt ein Windows Form oder ein Web Form hinzu.
Ziehen Sie im grafischen Entwurfsmodus das ReportViewer-Steuerelement aus der Gruppe Berichterstellung der Toolbox in das Windows Form oder Web Form. Das Steuerelement schließt den Smarttagbereich ReportViewer-Aufgaben ein, sodass Sie den Bericht sofort auswählen können.

Die Datei "web.config" wird automatisch mit dem HTTP-Handler für das ReportViewer-Steuerelement aktualisiert. Weitere Informationen finden Sie unter Web.config-Einstellungen für ReportViewer.

Tipp

Um das ReportViewer-Steuerelement in einem Web Form zu verwenden, müssen Sie der Seite außerdem ein ScriptManager-Steuerelement hinzufügen. Ziehen Sie im Fenster Toolbox in der Gruppe AJAX-Erweiterungen ein ScriptManager-Steuerelement auf die Entwurfsoberfläche oberhalb des ReportViewer-Steuerelements.
Wählen Sie im Smarttagbereich ReportViewer-Aufgaben die Aufgaben zum Hinzufügen eines Berichts und Konfigurieren des Steuerelements aus. Durch die Angabe des Berichts wird festgelegt, ob das Steuerelement für die lokale Verarbeitung oder für die Remoteverarbeitung konfiguriert wird.
- Klicken Sie auf Neuen Bericht entwerfen, um den Berichts-Assistenten zu starten und eine Berichtsdefinitionsdatei (RDLC) in der Anwendung zu erstellen. Sie können neue Berichte innerhalb der Anwendung erstellen, die lokal auf dem Client verarbeitet werden. Weitere Informationen zum Erstellen von Berichten finden Sie unter Erstellen von Client-Berichtsdefinitionsdateien (RDLC).
- Verwenden Sie Bericht auswählen, um eine vorhandene Berichtsdefinition auszuwählen. Sie können eine im Projekt definierte lokale Berichtsdefinitionsdatei (RDLC) oder die Option Serverbericht auswählen, um einen Bericht auszuwählen, der auf einem Berichtsserver mit SQL Server 2008 Reporting Services veröffentlicht wurde.
  
  Durch die Auswahl eines Serverberichts wird das Steuerelement für die Remoteverarbeitung konfiguriert. Sie müssen die URL des Berichtsservers und den Pfad zum Bericht kennen, um einen Serverbericht auswählen zu können. Beim Verweisen auf einen Bericht auf einem Berichtsserver im systemeigenen Modus beginnt der Berichtspfad mit einem Schrägstrich (/). Beim Verweisen auf einen Bericht auf einem Berichtsserver im integrierten SharePoint-Modus ist der Berichtspfad eine vollqualifizierte URL. Beispiel:
  
  Systemeigener Modus: /Adventureworks 2008 Sample Reports/Company Sales 2008
  
  Integrierter SharePoint-Modus: http://MyServer/sites/MySite/MyLibrary/Adventureworks 2008 Sample Reports/Company Sales 2008.rdl
  
  Sie müssen auf dem Berichtsserver über Zugriffsberechtigung auf den Bericht verfügen, um den Bericht ausführen zu können. Wenn Sie die URL oder den Berichtspfad nicht kennen, wenden Sie sich an den Administrator des Berichtsservers. Weitere Informationen zu Berichtsservern finden Sie unter Konfigurieren von ReportViewer für die Remoteverarbeitung.
  
  Durch die Auswahl einer vorhandenen Berichtsdefinitionsdatei (RDLC) wird das Steuerelement für die lokale Verarbeitung konfiguriert. Bei der Auswahl eines Berichts müssen Sie eine RDLC-Datei auswählen. Es ist nicht möglich, eine RDL-Datei anzugeben, und zwar auch dann nicht, wenn das Projekt eine solche Datei enthält. Weitere Informationen finden Sie unter Erstellen von Client-Berichtsdefinitionsdateien (RDLC).
- Klicken Sie auf In übergeordnetem Container andocken, um die Anzeigeoberfläche des ReportViewer-Steuerelements zu erweitern, sodass der gesamte verfügbare Platz im Formular oder auf der Seite verwendet wird. Diese Option wird zusammen mit dem Windows Forms-Steuerelement bereitgestellt.
- Klicken Sie auf Datenquellen erneut binden, um Datenquellenbindungen für Datentabellen und Geschäftsobjekte zu aktualisieren, die im Bericht verwendet werden. Diese Option ist verfügbar, nachdem Sie einen Bericht für das Steuerelement ausgewählt haben. Das erneute Binden einer Datenquelle ist notwendig, wenn Sie eine Berichtsdatenquelle ändern oder ein datengebundenes Berichtselement außerhalb der grafischen Berichtsentwurfsumgebung ändern (z. B. beim direkten Bearbeiten des XML-Codes).
Wählen Sie das ReportViewer-Steuerelement aus, und öffnen Sie das Eigenschaftenfenster.
Legen Sie Eigenschaften für das ReportViewer-Steuerelement fest, um die Sichtbarkeit und Verfügbarkeit von Anzeigebereichen festzulegen. Informationen zu den einzelnen Eigenschaften finden Sie in der Referenzdokumentation. Weitere Informationen finden Sie unter ReportViewer Properties. Informationen zur ReportViewer-Symbolleiste finden Sie unter Konfigurieren und Verwenden der ReportViewer-Symbolleiste.
Erstellen Sie einen Build der Anwendung, oder stellen Sie die Anwendung bereit, um eine Berichtsvorschau innerhalb des Formulars oder auf der Seite anzuzeigen.