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

Artikel
08/21/2008

In dieser Anleitung wird gezeigt, wie Sie einen Bericht für eine Microsoft Visual Studio 2008-ASP.NET-Website erstellen und ein ReportViewer-Steuerelement zu einer Webseite hinfügen können, sodass Benutzer den Bericht anzeigen können.

Erforderliche Komponenten

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

Weiterhin müssen Sie über Zugriffsberechtigungen auf einen Server mit Microsoft Internetinformationsdienste (Internet Information Services, IIS), Version 5.0 oder höher, verfügen, wobei Sie über die Berechtigungen zum Erstellen einer ASP.NET-Webseite verfügen müssen.

Führen Sie folgende Schritte auf dem Computer aus, um mithilfe von Visual Studio 2008-Vorlagen eine ASP.NET-Webseite mit einem ReportViewer-Steuerelement zu erstellen, das zum Anzeigen eines von Ihnen erstellten 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 die Option ASP.NET-Website aus.
Klicken Sie in der Liste Sprache auf Visual Basic, und klicken Sie dann auf OK.
Wählen Sie, sofern nicht bereits ausgewählt, im Feld Speicherort die Option HTTP aus, und klicken Sie dann auf Durchsuchen, um einen neuen Ordner anzusteuern.
Klicken Sie im Dialogfeld Speicherort auswählen auf Lokale IIS, und navigieren Sie zum Stammverzeichnis Ihrer Website.
Klicken Sie auf Neue Webanwendung erstellen, um einen neuen Ordner zu erstellen, und geben Sie einem Namen ein. Drücken Sie die EINGABETASTE.
Klicken Sie auf Öffnen.
Klicken Sie auf OK.

Das Websiteprojekt wird geöffnet, und die Webseite Default.aspx wird angezeigt.
Überprüfen Sie, ob im Projektmappen-Explorer der Eintrag Default.aspx markiert ist.
Wählen Sie im Menü Ansicht die Option Designer aus.

Sie können nun die Standardseite der Website ändern.

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.
Klicken Sie im Dialogfeld Neues Element hinzufügen auf DataSet. Klicken Sie auf Hinzufügen. Klicken Sie bei der Aufforderung, ob das Element dem Ordner App_Code hinzugefügt werden soll, auf Ja. Dadurch wird eine neue DataSet1.xsd-XSD-Datei zum Projekt hinzugefügt, der DataSet-Designer geöffnet und der TableAdapter-Konfigurations-Assistent aufgerufen.
Wenn Sie für die Installation von AdventureWorks SQLExpress verwendet haben, sehen Sie auf der Seite Wählen Sie Ihre Datenverbindung aus möglicherweise eine bestehende Datenverbindung mit der Bezeichnung sqlexpress.AdventureWorks.dbo, die Sie auswählen können, und Sie können mit Schritt 6 fortfahren. Klicken Sie andernfalls auf Neue Verbindung.
Wählen Sie im Dialogfeld Datenquelle die Option Microsoft SQL Server (SQL-Client) aus.
Geben Sie im Dialogfeld Servername den Namen des Servers ein, auf dem sich die AdventureWorks-Beispieldatenbank befindet. Beispielsweise ist der Standardinstanzname von SQL Server 2005 Express (local)\sqlexpress. Nachdem Sie den Servernamen eingegeben haben, wählen Sie in der Datenbank-Dopdownliste AdventureWorks aus, und klicken Sie auf OK.
Klicken Sie auf Weiter.
Geben Sie auf der Seite Verbindungszeichenfolge in der Anwendungskonfigurationsdatei speichern den Namen der Verbindungszeichenfolge ein, oder übernehmen Sie den Standardnamen AdventureWorksConnectionString. Klicken Sie auf Weiter.
Wählen Sie auf der Seite Wählen Sie einen Befehlstyp aus die Option SQL-Anweisungen verwenden aus. Stellen Sie sicher, dass keine anderen Optionsfelder ausgewählt sind.
Geben Sie auf der Seite SQL-Anweisung eingeben die folgende Transact-SQL-Abfrage zum Abrufen von Daten aus der AdventureWorks-Datenbank ein, und klicken Sie dann auf Fertig stellen. 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.
```
SELECT d.Name as Dept, s.Name as Shift, e.EmployeeID 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
```
Wenn die Abfrage nicht die erwarteten Daten zurückgibt, verwenden Sie möglicherweise eine frühere Version von AdventureWorks. Weitere Informationen zur Installation der SQL Server 2005-Version von AdventureWorks finden Sie unter Exemplarische Vorgehensweise: Installieren der AdventureWorks-Datenbank.
Übernehmen Sie auf der Seite Zu generierende Methode auswählen die folgenden Standardeinstellungen: DataTable füllen mit der Einstellung Fill unter Methodenname und DataTable zurückgeben mit der Einstellung GetData unter Methodenname. Klicken Sie auf Weiter.
Klicken Sie auf der Seite Assistentenergebnisse auf Fertig stellen.

Die Konfiguration des ADO.NET-Objekts DataTable 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.

Entwerfen des Berichts

Wählen Sie im Menü Website den Befehl Neues Element hinzufügen aus.
Wählen Sie im Dialogfeld Neues Element hinzufügen die Berichtsvorlage aus, geben Sie einen Namen für die Berichtsdatei ein, und klicken Sie dann auf Hinzufügen. Dadurch wird eine Berichtsdefinitionsdatei (der Standardname ist Report.rdlc) erstellt, der Berichts-Designer gestartet und das Fenster Website-Datenquellen angezeigt.
Öffnen Sie die Toolbox. Klicken Sie auf ein Textfeld und anschließend auf die Berichtsentwurfsoberfläche.
Geben Sie im Textfeld einen Berichtstitel ein: Anzahl der Mitarbeiter pro Schicht pro Abteilung. Erweitern Sie das Textfeld, sofern erforderlich.
Ziehen Sie aus der Toolbox ein Matrix-Berichtselement auf den Bericht unterhalb des Textfelds. Der gepunktete weiße Hintergrund ist die Berichtsseite. Um die Position der Matrix auf der Seite anzupassen, wählen Sie diese durch Klicken auf die linke Ecke aus, und ziehen Sie sie an die gewünschte Stelle. Sie können dazu auch die Pfeiltasten verwenden.
Erweitern Sie im Fenster Website-Datenquellen den Knoten DataTable1, bis die Spalten der Abfrage angezeigt werden. Ziehen Sie Dept auf das Textfeld Zeilen, das sich in der ersten Spalte und der zweiten Zeile der Matrix befindet.
Ziehen Sie Shift auf das Textfeld Spalten, das sich in der zweiten Spalte und der ersten Zeile der Matrix befindet. Legen Sie bei ausgewähltem Textfeld im Fenster Eigenschaften die Eigenschaft TextAlign auf Rechts fest. Klicken Sie in das Textfeld, um die Symbolleiste Berichtsformatierung zu aktivieren, und klicken Sie auf die Schaltfläche Fett.
Wählen Sie die Matrix aus, indem Sie auf eine beliebige Stelle in der Matrix klicken. Drücken Sie die rechte Maustaste, und wählen Sie die Matrix anhand ihres Namens aus (der Standardname ist matrix1). Ein Rahmen wird um das Matrixberichtselement angezeigt. Klicken Sie mit der rechten Maustaste auf den Rahmen, und wählen Sie Eigenschaften aus. Überprüfen Sie, ob der Titel des sich öffnenden Dialogfelds Matrixeigenschaften ist.
Klicken Sie auf die Registerkarte Gruppen. Klicken Sie im Abschnitt Spalten auf Bearbeiten.
Klicken Sie im Dialogfeld Sortieren und gruppieren auf die Registerkarte Sortierung.
Klicken Sie im ersten Feld unter Ausdruck, um das Textfeld zu aktivieren. Wählen Sie in der Dropdownliste =Fields!Dept.Value aus. Dadurch wird sichergestellt, dass die Berichtsdaten nach Abteilungsname sortiert werden. Klicken Sie auf OK.
Klicken Sie auf OK, um das Dialogfeld Matrixeigenschaften zu schließen.
Ziehen Sie das Feld EmployeeID vom Fenster Website-Datenquellen auf das Textfeld Daten, das sich in der zweiten Spalte und der zweiten Zeile der Matrix befindet. Klicken Sie mit der rechten Maustaste auf dieses Textfeld, und wählen Sie Ausdruck aus.
Bearbeiten Sie die standardmäßige SUM-Aggregatfunktion, und ändern Sie sie in COUNT. Klicken Sie auf OK.
Klicken Sie auf OK, um das Dialogfeld Textfeldeigenschaften zu schließen.
Wählen Sie im Menü Datei den Befehl Alle speichern aus.

Hinzufügen eines ReportViewer-Steuerelements zur Anwendung

Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf Default.aspx, und wählen Sie Ansicht-Designer aus.
Öffnen Sie das Fenster Toolbox. Ziehen Sie das ReportViewer-Steuerelement aus der Gruppe Daten auf die Seite.
Sofern nicht bereits geöffnet, öffnen Sie den Smarttagbereich ReportViewer Aufgaben, indem Sie auf der Webseite auf das Dreieck in der oberen rechten Ecke des ReportViewer-Steuerelements klicken. Wählen Sie im Feld Bericht auswählen den vollqualifizierten Namen für Report.rdlc 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.

Hinweis
Eine Erklärung, warum ASP.NET ein ObjectDataSource-Steuerelement statt eines SqlDataSource-Steuerelements verwendet, obwohl die zugrunde liegende Datenquelle möglicherweise eine Datenbank oder ein anderer Datenspeicher mit starker Typisierung ist, finden Sie unter Erstellen von Datenquellen für einen Bericht.

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

Freigeben über

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

Erforderliche Komponenten

Erstellen einer neuen Website

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

Entwerfen des Berichts

Hinzufügen eines ReportViewer-Steuerelements zur Anwendung

Erstellen eines Builds und Ausführen der Anwendung

Siehe auch

Verweis

Konzepte

Weitere Ressourcen

Zusätzliche Ressourcen