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: %PROGRAMFILES%\Microsoft SDKs\Windows\v7.0A\Bootstrapper\Packages\ReportViewer\ReportViewer.exe. Sie können die Datei auch vom Microsoft Download-Center herunterladen.
Tipp
Sie können unterschiedliche Versionen der weitervertreibbaren ReportViewer-Steuerelementdatei auf demselben Computer installieren.
Wenn Sie ReportViewer.exe ausführen, werden die folgenden Dateien im globalen Assemblycache des Bereitstellungscomputers installiert.
Microsoft.ReportViewer.Common.dll
Microsoft.ReportViewer.ProcessingObjectModel.dll
Microsoft.ReportViewer.WebForms.dll
Microsoft.ReportViewer.WinForms.dll
Microsoft.ReportViewer.DataVisualization.dll
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, auf dem die Anwendung gehostet ist. Für diese Aufgabe sind Serveradministratorrechte erforderlich.
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:
Öffnen Sie die Eigenschaftenseite des Projekts.
Klicken Sie auf Veröffentlichen und dann auf Erforderliche Komponenten.
Wählen Sie Berichts-Viewer von Microsoft Visual Studio 2010 aus, und klicken Sie auf OK.
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
Die weitervertreibbare ReportViewer-Steuerelementdatei ist in zehn Visual Studio-Sprachen lokalisiert: Chinesisch (vereinfacht), Chinesisch (traditionell), Französisch, Deutsch, Italienisch, Japanisch, Koreanisch, Portugiesisch (Brasilien), Russisch und Spanisch. Wenn Sie eine lokalisierte Version von Visual Studio installieren, finden Sie die lokalisierte ReportViewer-Steuerelementdatei unter %PROGRAMFILES%\Microsoft SDKs\Windows\v7.0A\BootStrapper\Packages\ReportViewer\<lang>. Außerdem können Sie alle lokalisierten weitervertreibbaren ReportViewer-Steuerelementdateien im Internet herunterladen.
Führen Sie folgende Schritte aus, um eine lokalisierte Version der im Lieferumfang von Visual Studio enthaltenen weitervertreibbaren ReportViewer-Steuerelementdatei zu verwenden:
Führen Sie ReportViewer.exe aus.
Wechseln Sie zum Ordner mit dem gewünschten Sprachpaket. Die Sprachpackordner befinden sich unter %PROGRAMFILES%\Microsoft SDKs\Windows\v7.0A\BootStrapper\Packages\ReportViewer\<lang>.
Führen Sie ReportViewerLP.exe aus.
Für die Verwendung anderer Sprachen in einem ReportViewer-Steuerelement können Sie die IreportViewerMessages3-Schnittstelle oder die IreportViewerMessages3-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 Thread.CurrentCulture und 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 Berichtsdateien
Zur Verteilung Ihrer Berichtsdateien mit Ihrer Anwendung haben Sie je nach Verarbeitungsmodus für das ReportViewer-Steuerelement verschiedene Möglichkeiten, es sei denn, Sie generieren die Client-Berichtsdefinition dynamisch zur Laufzeit mit der LocalReport.LoadReportDefinition-Methode oder der ServerReport.LoadReportDefinition-Methode.
Sie können lokal verarbeitete Berichte in einem Netzwerkordner speichern oder in die ausführbare Anwendungsdatei kompilieren. Berichte, die auf einem Remoteserver verarbeitet werden, werden in der Regel auf einem Berichtsserver mit SQL Server Reporting Services gespeichert. Sie müssen keine Berichtsdateien in Ihre Anwendung einschließen, es sei denn, Sie möchten mit der ServerReport.LoadReportDefinition-Methode einen Bericht manuell von einem anderen Speicherort als dem Berichtsserver laden. 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