Anleitung: Verwenden einer Geschäftsobjekt-Datenquelle mit dem ReportViewer-Windows Forms-Steuerelement im lokalen Verarbeitungsmodus

Artikel
07/31/2015

In dieser exemplarischen Vorgehensweise wird die Verwendung einer Objektdatenquelle mithilfe von Geschäftsobjekten in einem Bericht in einer Windows Forms-Anwendung veranschaulicht, die mit Microsoft Visual Studio erstellt wurde.Weitere Informationen zu Geschäftsobjekten und Objektdatenquellen finden Sie unter Binding to Business Objects.

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 C#.

Erstellen eines neuen Windows Forms-Anwendungsprojekts

Zeigen Sie im Menü Datei auf Neu, und wählen Sie Projekt aus.
Wählen Sie im Dialogfeld Neues Projekt im Bereich Installierte Vorlagen den Eintrag "Visual C#" aus, und wählen Sie dann die Vorlage Windows Forms-Anwendung aus.Der Knoten C# kann sich unter Andere Sprachen befinden. Dies hängt von den Starteinstellungen in Visual Studio ab.
Geben Sie BusinessObject als Projektnamen ein, und klicken Sie auf OK.

Erstellen von als Datenquelle zu verwendenden Geschäftsobjekten

Wählen Sie im Menü Projekt die Option Neues Element hinzufügen aus.
Wählen Sie im Dialogfeld Neues Element hinzufügen die Option Klasse aus, geben Sie BusinessObjects.cs als Dateinamen ein, und klicken Sie dann auf Hinzufügen.

Die neue Datei wird dem Projekt hinzugefügt und automatisch in Visual Studio geöffnet.

Ersetzen Sie den Standardcode für BusinessObjects.cs durch den folgenden Code:

using System;
using System.Collections.Generic;

// Define the Business Object "Product" with two public properties
//    of simple datatypes.
public class Product {
    private string m_name;
    private int m_price;

    public Product(string name, int price) {
        m_name = name;
        m_price = price;
    }

    public string Name {
        get {
            return m_name;
        }
    }

    public int Price {
        get {
            return m_price;
        }
    }
}

// Define Business Object "Merchant" that provides a 
//    GetProducts method that returns a collection of 
//    Product objects.

public class Merchant {
    private List<Product> m_products;

    public Merchant() {
        m_products = new List<Product>();
        m_products.Add(new Product("Pen", 25));
        m_products.Add(new Product("Pencil", 30));
        m_products.Add(new Product("Notebook", 15));
    }

    public List<Product> GetProducts() {
        return m_products;
    }
}

Wählen Sie im Menü Projekt die Option Projektmappe erstellen aus.Dadurch wird eine Assembly für das Objekt erstellt, das Sie später als Datenquelle für den Bericht verwenden.

Hinzufügen eines Berichts zum Projekt mit dem Berichts-Assistenten

Wählen Sie im Menü Projekt die Option 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 den Bericht ein, und klicken Sie auf Hinzufügen.

Dadurch wird der Berichts-Assistent mit dem Assistenten zum Konfigurieren von Datenquellen gestartet.
Wählen Sie auf der Seite Einen Datenquellentyp auswählen die Option Objekt aus, und klicken Sie dann auf Weiter.
Erweitern Sie auf der Seite Datenobjekte auswählen die Klassenhierarchie unter BusinessObjects, bis Sie Product in der Liste sehen.Wählen Sie Product aus, und klicken Sie auf Fertig stellen.

Jetzt kehren Sie zum Berichts-Assistenten zurück.Beachten Sie, dass das neue Datenquellenobjekt Ihrem Projekt im Projektmappen-Explorer hinzugefügt wird.
Überprüfen Sie auf der Seite Dataseteigenschaften im Feld Datenquelle, ob die Option global ausgewählt ist.
Überprüfen Sie im Feld Verfügbare Datasets, ob Product ausgewählt ist.
Klicken Sie auf Weiter.
Führen Sie auf der Seite Felder anordnen folgende Schritte aus:
1. Ziehen Sie Name von Verfügbare Felder in das Feld Zeilengruppen.
2. Ziehen Sie Price von Verfügbare Felder in das Feld Werte.
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 erstellte Tablix wird auf der Entwurfsoberfläche angezeigt.
Speichern Sie die RDLC-Datei.

Hinzufügen eines ReportViewer-Steuerelements zum Bericht

Öffnen Sie das Windows Form im Projektmappen-Explorer in der Entwurfsansicht.Standardmäßig lautet der Formularname Form1.cs.
Ziehen Sie das Symbol ReportViewer aus der Gruppe Berichterstellung der Toolbox auf das Formular.
Öffnen Sie im ReportViewer-Steuerelement den Smarttagbereich, indem Sie auf das Smarttagsymbol in der rechten oberen Ecke klicken.
Wählen Sie in der Liste Bericht auswählen den soeben entworfenen Bericht aus.Standardmäßig lautet der Name Report1.rdlc.Beachten Sie, dass automatisch ein BindingSource-Objekt mit dem Namen ProductBindingSource für jede Objektdatenquelle erstellt wird, die im Bericht verwendet wird.
Wählen Sie im geöffneten Smarttagbereich die Option In übergeordnetem Container andocken aus.

Angeben von Datenquelleninstanzen für das BindingSource-Objekt

Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf das Form1.cs, und wählen Sie Code anzeigen aus.
Fügen Sie in der Datei Form1.cs in der partiellen Klassendefinition als erste Zeile vor dem Konstruktor den folgenden Code hinzu.
```
// Instantiate the Merchant class.
private Merchant m_merchant = new Merchant();
```

Fügen Sie in der Form1_Load()-Methode den folgenden Code als erste Zeile vor dem RefreshReport-Aufruf hinzu:

// Bind the Product collection to the DataSource.
this.ProductBindingSource.DataSource = m_merchant.GetProducts();

Ausführen der Anwendung

Drücken Sie F5, um die Anwendung auszuführen und den Bericht anzuzeigen.

Siehe auch

Referenz

ReportViewer.Drillthrough

LocalReport.SubreportProcessing