Bereitstellen von Berichten und ReportViewer-Steuerelementen

Sie können Berichte und die ReportViewer-Steuerelemente ohne Einschränkung als Teil Ihrer Anwendung vertreiben. Die Bereitstellungsanforderungen variieren erheblich in Abhängigkeit vom Steuerelementtyp und davon, ob die Konfiguration des Berichts die lokale oder die Remoteverarbeitung vorsieht. Sie können lokal und remote verarbeitete Berichte in derselben Anwendung bereitstellen.

Weitervertreiben der ReportViewer-Steuerelemente

Die weitervertreibbare ReportViewer-Steuerelementdatei ist eine selbstextrahierende Datei mit dem Namen ReportViewer.exe, die eine MSI-Datei sowie weitere Dateien enthält. Der Speicherort der Datei ReportViewer.exe ist: C:\Programme\Microsoft Visual Studio 8\SDK\v2.0\BootStrapper\Packages\ReportViewer\ReportViewer.exe.

Wenn Sie ReportViewer.exe ausführen, werden die folgenden Dateien in den globalen Assemblycache des Bereitstellungscomputers kopiert.

Datei	Beschreibung
Microsoft.ReportViewer.Common	Stellt grundlegende Berichtsfunktionen für das Windows Forms- und das Webserver-Steuerelement von ReportViewer bereit.
Microsoft.ReportViewer.ProcessingObjectModel	Macht das Objektmodell verfügbar, damit es von Ausdrücken programmgesteuert in der Berichtsdefinition zur Laufzeit aufgerufen werden kann.
Microsoft.ReportViewer.WebForms	Stellt das ReportViewer-Steuerelement für ASP.NET-Seiten bereit.
Microsoft.ReportViewer.WinForms	Stellt das ReportViewer-Steuerelement für Windows-Anwendungen bereit.

Ausführen der Datei ReportViewer.exe

Die Art des verwendeten Steuerelements bestimmt, wo ReportViewer.exe ausgeführt werden soll.

• Führen Sie für ASP.NET-Anwendungen ReportViewer.exe auf dem Webserver aus, der die Anwendung hostet.

• Schließen Sie bei Windows Forms-Anwendungen die Steuerelemente als erforderliche Komponente ein, damit diese automatisch mit der Anwendung installiert werden. Dieser Schritt lässt sich mithilfe der Bootstrapping-Anwendung automatisieren:

  1. Öffnen Sie die Eigenschaftenseite des Projekts.

  2. Klicken Sie auf Veröffentlichen und dann auf Erforderliche Komponenten.

  3. Wählen Sie Berichts-Viewer von Microsoft Visual Studio 2008 aus, und klicken Sie auf OK.

  4. Veröffentlichen Sie die Anwendung.

Während der Anwendungsinstallation wird der lokale Computer überprüft, um festzustellen, ob ReportViewer bereits installiert ist. Wenn die Anwendung nicht installiert ist, wird diese von Setup installiert.

Bereitstellen von lokalisierten Versionen von ReportViewer-Steuerelementen

Das ReportViewer-Steuerelement enthält Sprachpakete für zehn Visual Studio-Sprachen: Chinesisch (vereinfacht), Chinesisch (traditionell), Französisch, Deutsch, Italienisch, Japanisch, Koreanisch, Portugiesisch (Brasilien), Russisch und Spanisch. Führen Sie folgende Schritte aus, um eine lokalisierte Version des Steuerelements zu verwenden:

1. Führen Sie ReportViewer.exe aus.

2. Wechseln Sie zum Ordner mit dem gewünschten Sprachpaket. Die Sprachpaketordner befinden sich unter <Laufwerk>:\Programme\Microsoft SDKs\Windows\v6.0A\BootStrapper\Packages\ReportViewer\<Sprache>.

3. Führen Sie ReportViewerLP.exe aus.

Für die Verwendung anderer Sprachen in einem ReportViewer-Steuerelement können Sie Microsoft.Reporting.WebForms.IReportViewerMessages-Schnittstelle oder die Microsoft.Reporting.WinForms.IReportViewerMessages-Schnittstelle implementieren, um QuickInfos und andere Texte für die Benutzeroberfläche in einer bestimmten Sprache zu erstellen.

Erkennen von Browsersprache und Kultureinstellungen

Wenn Sie Berichte mithilfe eines ReportViewer-Webserver-Steuerelements in einer Browser-Anwendung hosten, müssen Sie die Threadkultur festlegen, wenn Sie eine der Browsersprache und den Kultureinstellungen entsprechende Benutzeroberfläche bereitstellen möchten. ASP.NET legt die Threadkultur nicht auf Grundlage der vom Client bereitgestellten Headerinformationen fest. Damit die Anwendung mit den Kultureinstellungen des Browsers übereinstimmt, können Sie im Anwendungscode System.Threading.Thread.CurrentCulture und System.Threading.Thread.CurrentUICulture festlegen. Weitere Informationen zur Verwendung von Kultureinstellungen in der Anwendung finden Sie unter System.Globalization.CultureInfo.

Überlegungen zur Bereitstellung des ReportViewer-Webserver-Steuerelements

Für die Bereitstellung einer ASP.NET-Anwendung in einer Webfarm sind weitere Konfigurationsschritte erforderlich, um sicherzustellen, dass der Anzeigestatus in der gesamten Webfarm beibehalten wird. Wenn Sie das ReportViewer-Webserver-Steuerelement in einer Webfarmumgebung bereitstellen, sollten Sie das machineKey-Element in der Datei Web.config der Anwendung angeben. Weitere Informationen finden Sie unter Web.config-Einstellungen für ReportViewer.

Für Berichte, die im ReportViewer-Webserver_Steuerelement verarbeitet werden, gelten bestimmte Browseranforderungen. Browserkompatibilitätsprobleme können sich auf die Verfügbarkeit bestimmter Berichtsfunktionen auswirken. Weitere Informationen finden Sie unter Browserunterstützung für ReportViewer-Webserversteuerelemente.

Verteilen von Berichten

Sofern Sie die Client-Berichtsdefinitionsdateien (RDLC) nicht dynamisch zur Laufzeit generieren, werden lokal verarbeitete Berichte als RDLC-Dateien im Dateisystem gespeichert und müssen im Lieferumfang der Anwendung enthalten sein. Die Dateien können auf dem Laufwerk installiert werden oder beim Kompilieren in die ausführbare Datei der Anwendung eingebunden werden.

Berichte, die auf einem Remoteserver verarbeitet werden, werden auf einem Berichtsserver mit Microsoft SQL Server 2005 Reporting Services gespeichert. In diesem Fall müssen keine Berichtsdateien in die Anwendung eingebunden werden, da die Berichte remote verarbeitet werden und auf dem lokalen System nicht vorhanden sind. Zum Bereitstellen von Berichten, die auf einem Berichtsserver veröffentlicht werden, müssen Sie den ständigen Zugriff auf den Berichtsserver ermöglichen, um sicherzustellen, dass Benutzer der Anwendung autorisiert sind, Berichte auf diesem Server anzuzeigen. Für das Bereitstellen von Serverberichten müssen Sie mit den Authentifizierungserweiterungen, die vom Berichtsserver verwendet werden, und dem rollenbasierten Authentifizierungsmodell vertraut sein, das den Zugriff auf Inhalte und die Ausführung von Vorgängen ermöglicht. Weitere Informationen finden Sie unter Aspekte der Bereitstellung von Serverberichten.

Siehe auch

Konzepte

Hinzufügen und Konfigurieren der ReportViewer-Steuerelemente
Web.config-Einstellungen für ReportViewer
Konfigurieren von ReportViewer für asynchrones Rendering
Konfigurieren und Verwenden der ReportViewer-Symbolleiste