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

Artikel
07/31/2015

In dieser exemplarischen Vorgehensweise wird gezeigt, wie Sie einen Bericht in einem Windows Forms-Anwendungsprojekt erstellen und einem Windows Form ein ReportViewer-Steuerelement hinzufügen, sodass der Bericht von Benutzern der Anwendung angezeigt werden kann.

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 die folgenden Schritte aus, um einem Windows Forms-Anwendungsprojekt einen Bericht hinzuzufügen.Bei diesem Beispiel erstellen Sie die Anwendung in Microsoft Visual Basic.

Erstellen eines neuen Windows-Anwendungsprojekts

Öffnen Sie Visual Studio.Zeigen Sie im Menü Datei auf Neu, und klicken Sie dann auf Projekt.
Wählen Sie im Bereich Installierte Vorlagen die Option Visual Basic aus, und wählen Sie dann Windows Forms-Anwendung aus.Der Knoten Visual Basic kann sich unter Andere Sprachen befinden. Dies hängt von den Starteinstellungen in Visual Studio ab.
Geben Sie im Feld Name den Namen des Projekts ein: ReportWalkthrough.
Geben Sie im Feld Speicherort das Verzeichnis ein, in dem das Projekt gespeichert werden soll, oder klicken Sie auf Durchsuchen, um zu dem Verzeichnis zu navigieren.
Klicken Sie auf OK.

Der Windows Forms-Designer wird geöffnet und zeigt Form1.vb des von Ihnen erstellten Projekts an.

Definieren einer Datenquellenverbindung und DataTable

Wählen Sie im Menü Projekt die Option Neues Element hinzufügen aus.
Klicken Sie im Dialogfeld Neues Element hinzufügen auf DataSet.
Geben Sie einen Namen für das Dataset ein, und klicken Sie dann auf Hinzufügen.Hiermit wird dem Projekt eine neue XML-Schemadatei hinzugefügt und der DataSet-Designer geöffnet.Der Standardname ist DataSet1.xsd.
Öffnen Sie im DataSet-Designer die Toolbox, und ziehen Sie ein TableAdapter-Element auf die DataSet-Entwurfsoberfläche.Dadurch wird der TableAdapter-Konfigurations-Assistent geöffnet.
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 auf der Seite 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 auf AdventureWorks2008.
- Klicken Sie auf OK, um wieder zum Assistenten zurückzukehren.
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.
Klicken Sie auf Weiter.
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
```
Sie können auch auf die Schaltfläche Abfrage-Generator klicken und die Abfrage mit dem Abfrage-Generator erstellen. Anschließend können Sie sie 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.
Klicken Sie auf der Seite Zu generierende Methode auswählen auf Fertig stellen.

Auf der DataSet-Entwurfsoberfläche sollte DataTable1 mit den aus der Abfrage resultierenden Spalten angezeigt werden.

Entwerfen des Berichts mit dem Berichts-Assistenten

Wählen Sie im Menü Projekt die Option Neues Element hinzufügen aus.
Klicken Sie im Dialogfeld Neues Element hinzufügen auf Berichts-Assistent.
Geben Sie einen Namen für die Berichtdatei ein.Standardmäßig lautet der Berichtsname Report1.rdlc.Klicken Sie 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 zweimal auf Weiter, und klicken Sie dann auf Fertig stellen.

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

Öffnen Sie die Datei "Form1.vb" im Projekt im Entwurfsmodus.
Erweitern Sie im Eigenschaftenfenster Formular die Size-Eigenschaft, und legen Sie dann die Height-Eigenschaft auf 700 fest.
Ziehen Sie das ReportViewer-Steuerelement aus dem Bereich Berichterstellung der Toolbox auf das Formular.
Öffnen Sie den Smarttagbereich des ReportViewer-Steuerelements, indem Sie auf das Smarttagsymbol in der rechten oberen Ecke klicken.Klicken Sie auf die Dropdownliste Bericht auswählen, und wählen Sie den erstellten Bericht aus.Wird ein Bericht ausgewählt, werden automatisch Instanzen der im Bericht verwendeten Datenquellen erstellt.Es wird Code generiert, um ein DataSet (der ADO.NET-Container für eine DataTable), eine TableAdapter-Komponente und ein BindingSource-Objekt entsprechend jeder im Bericht verwendeten Datenquelle zu instanziieren.
Wählen Sie im geöffneten Smarttagbereich die Option In übergeordnetem Container andocken aus.

Erstellen und Ausführen der Anwendung

Klicken Sie im Menü Erstellen auf ReportWalkthrough erstellen.Im Rahmen des Erstellungsprozesses wird der Bericht kompiliert.Manche Fehler (z. B. Syntaxfehler in einem im Bericht verwendeten Ausdruck) werden in der Aufgabenliste vermerkt.
Drücken Sie F5, um die Anwendung auszuführen und den Bericht im Formular anzuzeigen.

Siehe auch

Referenz

ReportViewer.Drillthrough

LocalReport.SubreportProcessing