Anleitung: Verwenden einer Datenbank-Datenquelle mit dem ReportViewer-Webserver-Steuerelement im lokalen Verarbeitungsmodus

Artikel
07/31/2015

In dieser exemplarischen Vorgehensweise wird gezeigt, wie Sie einen Bericht für eine ASP.NET-Website erstellen und einer Webseite ein ReportViewer-Steuerelement hinzufügen, sodass Benutzer den Bericht anzeigen können.

Vorbereitungsmaßnahmen

Um diese exemplarische Vorgehensweise anzuwenden, müssen Sie über Zugriff auf die AdventureWorks2008-Beispieldatenbank verfügen.Weitere Informationen finden Sie unter Anleitung: Installieren der AdventureWorks-Datenbank.

Führen Sie folgende Schritte auf dem Computer aus, um eine ASP.NET-Webseite mit einem ReportViewer-Steuerelement zu erstellen, das zum Anzeigen eines lokalen Berichts konfiguriert wurde.Bei diesem Beispiel erstellen Sie die Anwendung in Microsoft Visual Basic.

Erstellen einer neuen Website

Zeigen Sie im Menü Datei auf Neu, und wählen Sie dann Website aus.
Wählen Sie im Dialogfeld Neue Website im Bereich Installierte Vorlagen den Eintrag Visual Basic aus, und wählen Sie dann ASP.NET-Website.
Geben Sie im Feld Speicherort ein Projektverzeichnis ein, und klicken Sie auf OK.

Das Websiteprojekt wird geöffnet.

Definieren einer Datenverbindung und eines DataTable-Objekts durch Hinzufügen eines DataSet-Objekts

Wählen Sie im Menü Website die Option Neues Element hinzufügen aus.
Wählen Sie im Dialogfeld Neues Element hinzufügen die Option DataSet aus, und klicken Sie dann auf Hinzufügen.Klicken Sie bei der Aufforderung, ob das Element dem Ordner App_Code hinzugefügt werden soll, auf Ja.

Hiermit wird dem Projekt die neue XSD-Datei DataSet1.xsd hinzugefügt und der DataSet-Designer geöffnet.
Ziehen Sie ein TableAdapter-Steuerelement aus dem Fenster "Toolbox" auf die Entwurfsoberfläche.Dadurch wird der TableAdapter-Konfigurations-Assistent aufgerufen.
Klicken Sie auf der Seite Wählen Sie Ihre Datenverbindung aus auf Neue Verbindung.
Wenn Sie zum ersten Mal eine Datenquelle in Visual Studio erstellen, wird die Seite Datenquellen auswählen angezeigt.Wählen Sie im Dialogfeld Datenquelle die Option Microsoft SQL Server.
Führen Sie im Dialogfeld Verbindung hinzufügen die folgenden Schritte aus:
- Geben Sie in das Feld Servername den Server ein, auf dem sich die AdventureWorks2008-Datenbank befindet.
  
  Die standardmäßige SQL Server Express-Instanz ist (local)\sqlexpress.
- Wählen Sie im Abschnitt Beim Server anmelden die Option aus, die Zugriff auf die Daten bietet.Windows-Authentifizierung verwenden ist die Standardeinstellung.
- Klicken Sie in der Dropdownliste Wählen Sie einen Datenbanknamen aus, oder geben Sie ihn ein auf AdventureWorks2008.
- Klicken Sie auf Weiter.
Wenn Sie im vorherigen Schritt SQL Server-Authentifizierung verwenden angegeben haben, wählen Sie aus, ob vertrauliche Daten in die Zeichenfolge aufgenommen werden sollen, oder legen Sie die Informationen im Anwendungscode fest.
Geben Sie auf der Seite Verbindungszeichenfolge in der Anwendungskonfigurationsdatei speichern den Namen der Verbindungszeichenfolge ein, oder übernehmen Sie den Standardnamen AdventureWorks2008ConnectionString.Klicken Sie auf Weiter.
Wählen Sie auf der Seite Wählen Sie einen Befehlstyp aus die Option SQL-Anweisungen verwenden aus, und klicken Sie dann auf Weiter.
Geben Sie auf der Seite SQL-Anweisung eingeben die folgende Transact-SQL-Abfrage zum Abrufen von Daten aus der AdventureWorks2008-Datenbank ein, und klicken Sie dann auf Fertig stellen.
```
SELECT d.Name as Dept, s.Name as Shift, 
    e.BusinessEntityID as EmployeeID
FROM (HumanResources.Department d
INNER JOIN HumanResources.EmployeeDepartmentHistory e
    ON d.DepartmentID = e.DepartmentID)
INNER JOIN HumanResources.Shift s
    ON e.ShiftID = s.ShiftID
```
Zum Erstellen der Abfrage mit dem Abfrage-Generator können Sie auch auf die Schaltfläche Abfrage-Generator klicken, und dann mit der Schaltfläche Abfrage ausführen überprüfen.Wenn die Abfrage nicht die erwarteten Daten zurückgibt, verwenden Sie möglicherweise eine ältere Version von AdventureWorks.Weitere Informationen zur Installation der AdventureWorks2008-Version von AdventureWorks finden Sie unter Anleitung: Installieren der AdventureWorks-Datenbank.
Die Konfiguration des DataTable-ADO.NET-Objekts als Datenquelle für den Bericht ist nun abgeschlossen.Auf der Seite DataSet-Designer von Visual Studio sollte das von Ihnen hinzugefügte DataTable-Objekt angezeigt werden (der Standardname ist DataTable1), in dem die Spalten aufgelistet sind, die sich aus der Abfragedefinition ergeben.Wenn Sie im Menü Daten den Befehl Datenvorschau auswählen und auf Vorschau klicken, können Sie die Abfrageergebnisse überprüfen.
Klicken Sie auf der Seite Zu generierende Methode auswählen auf Fertig stellen.
Speichern Sie die Datei.

Entwerfen des Berichts mit dem Berichts-Assistenten

Vergewissern Sie sich, dass im Projektmappen-Explorer die Website der obersten Ebene ausgewählt ist.
Klicken Sie mit der rechten Maustaste auf die Website, und wählen Sie Neues Element hinzufügen aus.
Wählen Sie im Dialogfeld Neues Element hinzufügen die Option Berichts-Assistent aus, geben Sie einen Namen für die Berichtsdatei ein, und klicken Sie dann auf Hinzufügen.

Der Berichts-Assistent wird gestartet.
Wählen Sie auf der Seite DataSet-Eigenschaften im Feld Datenquelle das DataSet aus, das Sie erstellt haben.

Das Feld Verfügbare Datasets wird automatisch mit der von Ihnen erstellten DataTable aktualisiert.
Klicken Sie auf Weiter.
Führen Sie auf der Seite Felder anordnen folgende Schritte aus:
1. Ziehen Sie Dept von Verfügbare Felder in das Feld Zeilengruppen.
2. Ziehen Sie Shift von Verfügbare Felder in das Feld Spaltengruppen.
3. Ziehen Sie EmployeeID von Verfügbare Felder in das Feld Werte.
4. Klicken Sie auf den Pfeil neben Sum(EmplyeeID), und wählen Sie Anzahl aus.
Klicken Sie auf Weiter und dann auf Fertig stellen, um den Berichts-Assistenten abzuschließen.

Dadurch wird die RDLC-Datei erstellt und im Berichts-Designer geöffnet.Der von Ihnen entworfene Tablix wird auf der Entwurfsoberfläche angezeigt.
Speichern Sie die RDLC-Datei.

Hinzufügen eines ReportViewer-Steuerelements zur Anwendung

Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf das Web Form Default.aspx, und wählen Sie Designer anzeigen aus.
Öffnen Sie das Fenster Toolbox.Ziehen Sie aus der Gruppe AJAX-Erweiterungen ein ScriptManager-Steuerelement auf die Entwurfsoberfläche.
Ziehen Sie im Fenster Toolbox in der Gruppe Berichterstellung ein ReportViewer-Steuerelement auf die Seite unter das ScriptManager-Steuerelement.
Falls dieser nicht bereits geöffnet ist, öffnen Sie den Smarttagbereich ReportViewer-Aufgaben, indem Sie auf das Smarttagsymbol in der oberen rechten Ecke klicken.Wählen Sie im Feld Bericht auswählen den erstellten Bericht aus.

Wenn Sie einen Bericht auswählen, werden automatisch Instanzen der im Bericht verwendeten Datenquellen erstellt.Es wird Code generiert, um jedes DataTable-Objekt (und das zugehörige DataSet-Containerobjekt) sowie ein ObjectDataSource-Steuerelement zu instanziieren, das den einzelnen im Bericht verwendeten Datenquellen entspricht.Dieses Datenquellensteuerelement wird automatisch konfiguriert.

Erstellen eines Builds und Ausführen der Anwendung

Drücken Sie STRG+F5, um die Seite ohne Debuggen auszuführen, oder drücken Sie F5, um die Seite mit Debuggen auszuführen.

Im Rahmen des Erstellungsprozesses wird der Bericht kompiliert, und alle festgestellten Fehler (z. B. ein Syntaxfehler in einem Ausdruck, der im Bericht verwendet wird) werden der Aufgabenliste hinzugefügt.

Die Webseite wird im Browser angezeigt.Das ReportViewer-Steuerelement zeigt den Bericht an.Mithilfe der Symbolleiste können Sie den Bericht durchsuchen, die Zoomfunktion verwenden und den Bericht nach Excel exportieren.
Schließen Sie den Browser.

Siehe auch

Referenz

ReportViewer.Drillthrough

LocalReport.SubreportProcessing