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. Sie können ReportViewer.exe aus dem Microsoft Download Center herunterladen.
Hinweis
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-ClickOnce-Anwendungen die Steuerelemente als erforderliche Anwendungskomponenten ein, damit diese automatisch mit der ClickOnce-Anwendung installiert werden. Dieser Schritt lässt sich mithilfe der Bootstrapping-Anwendung automatisieren:
Öffnen Sie die Eigenschaftenseite des Projekts.
Klicken Sie auf die Registerkarte Veröffentlichen, und klicken Sie dann auf die Schaltfläche Erforderliche Komponenten.
Wählen Sie den Berichts-Viewer von Microsoft Visual Studio und SQL Server-CLR-Typen aus, und klicken Sie auf OK.
Überprüfen Sie, ob die Option Erforderliche Komponenten von der Website des Komponentenherstellers herunterladen aktiviert ist. Dies ist die einzige unterstützte Option. Klicken Sie dann auf OK.
Klicken Sie auf die Schaltfläche Optionen.
Geben Sie auf der Registerkarte Bereitstellung eine Bereitstellungswebseite an, und aktivieren Sie das Kontrollkästchen Nach jeder Veröffentlichung automatisch Bereitstellungswebseite generieren.
Klicken Sie auf OK, und veröffentlichen Sie die Anwendung.
Wenn Sie auf eine ClickOnce-Anwendung zugreifen, z. B. über eine Webseite, wird eine Prüfung auf dem Clientcomputer ausgeführt, um festzustellen, ob die erforderlichen ReportViewer-Komponenten bereits installiert sind. Wenn sie nicht installiert sind, werden 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, können Sie lokalisierte, weitervertreibbare ReportViewer-Steuerelemente vom Microsoft Download Center herunterladen.
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.
.gif "ms251723.collapse_all(de-de,VS.140).gif")
Erkennen von Browsersprache und Kultureinstellungen
Wenn Sie Berichte mithilfe eines ReportViewer-Webserversteuerelements 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-Webserversteuerelements
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-Webserversteuerelement 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