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

Artikel
08/21/2008

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

Führen Sie die folgenden Schritte aus, um einen Bericht zu einem Visual Studio-Windows-Anwendungsprojekt hinzuzufügen. In diesem Beispiel erstellen Sie die Anwendung in Microsoft Visual C#.

Erstellen eines neuen Windows-Anwendungsprojekts

Zeigen Sie im Menü Datei auf Neu, und wählen Sie Projekt aus.
Wählen Sie im Dialogfeld Neues Projekt unter Visual C# die Vorlage Windows-Anwendung aus.
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 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

Vergewissern Sie sich, dass das Projekt oder ein Projektelement im Projektmappen-Explorer ausgewählt ist.
Wählen Sie im Menü Projekt die Option Neues Element hinzufügen aus.
Wählen Sie im Dialogfeld Neues Element hinzufügen die Option Bericht aus. Geben Sie einen Namen für den Bericht ein, und klicken Sie dann auf Hinzufügen. Der Bericht wird dem Projekt hinzugefügt und automatisch im Berichts-Designer geöffnet. Standardmäßig lautet der Berichtsname Report1.rdlc.

Verwenden des Assistenten zum Konfigurieren von Datenquellen zum Erstellen von Datenquellen

Vergewissern Sie sich, dass das Projekt oder ein Projektelement im Projektmappen-Explorer ausgewählt ist.
Wählen Sie im Menü Daten die Option Neue Datenquelle hinzufügen aus. Dadurch wird der Assistent 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.
Vom Assistenten zum Konfigurieren von Datenquellen wird eine Liste vorhandener Klassen im Projekt angezeigt. Erweitern Sie die Klassenhierarchie unter BusinessObjects, bis Sie Product in der Liste sehen. Wählen Sie Product aus. Klicken Sie anschließend auf Weiterund dann auf Fertig stellen.

Nachdem der Assistent geschlossen wurde, wird das neue Datenquellenobjekt im Fenster Datenquellen angezeigt.

Entwerfen des Berichts

Öffnen Sie die Toolbox, während der Bericht im Entwurfsmodus geöffnet ist. Ziehen Sie aus der Toolbox ein Tabellen-Steuerelement in den Bericht. Das Tabellensteuerelement wird im Entwurfssichtsfenster des Berichts angezeigt. Beachten Sie, dass der gepunktete Hintergrund die Dimensionen des Hauptteils des Berichts darstellt und die Größe oder Position des Tabellensteuerelements geändert werden kann.
Ziehen Sie im Fenster Datenquellen aus der Datenquelle Produkt das Feld Name auf die erste Spalte der Zeile Detail der Tabelle. Die Zeile Detail ist die mittlere Zeile. Beachten Sie, dass die Kopfzeile automatisch ausgefüllt wird, wenn Sie die Zeile Detail angeben.

Hinweis

Wenn das Fenster Datenquellen nicht angezeigt wird, wählen Sie im Menü Daten die Option Datenquellen anzeigen aus.
Ziehen Sie das Feld Preis in die Zeile Detail der zweiten Spalte, sodass es sich neben dem Feld Name befindet. Bei Bedarf können Sie die Kopfzeile der Tabelle markieren, indem Sie auf das linke Tabellenkopfsymbol klicken und den Schriftschnitt Fett anwenden.
Löschen Sie die nicht verwendete dritte Spalte. Klicken Sie auf die dritte Spalte, klicken Sie dann auf die Kopfzeilenleiste, und drücken Sie die ENTF-Taste.
Um dem Bericht einen Titel hinzuzufügen, öffnen Sie die Toolbox und ziehen ein Textfeld-Steuerelement auf den Bericht. Positionieren Sie das Textfeld oberhalb der Tabelle. Geben Sie Products als Berichtsnamen ein.
Bei Bedarf können Sie Schriftgrad und Schriftschnitt für den Text festlegen, um den Titel hervorzuheben.

Hinweis
Wenn das Fenster Datenquellen nicht angezeigt wird, wählen Sie im Menü Daten die Option Datenquellen anzeigen aus.

Hinzufügen eines ReportViewer-Steuerelements zum Bericht

Wählen Sie das automatisch generierte Windows-Anwendungsformular in der Entwurfsansicht aus. Standardmäßig lautet der Formularname Form1.cs.
Öffnen Sie die Toolbox. Erweitern Sie in der Toolbox den Knoten Daten, und ziehen Sie das Symbol ReportViewer auf das Formular. Erweitern Sie das Formular, und ändern Sie die ReportViewer-Position nach Bedarf.
Wählen Sie das ReportViewer-Steuerelement aus. Öffnen Sie dann den Smarttagbereich, indem Sie auf das Dreieck in der oberen rechten Ecke klicken. Klicken Sie auf die Dropdownliste Bericht auswählen, und wählen Sie den zuvor entworfenen Bericht aus. Standardmäßig lautet der Name Report1.rdlc. Beachten Sie, dass automatisch ein BindingSource-Objekt erstellt wird, das den im Bericht verwendeten Objektdatenquellen entspricht.

Angeben von Datenquelleninstanzen für das BindingSource-Objekt

Klicken Sie mit der rechten Maustaste auf das Visual Studio-Formular, und wählen Sie dann im Kontextmenü die Option Code anzeigen aus.
Fügen Sie in Form1.cs am Anfang der Klasse folgenden Code hinzu. Sie können die erste Zeile nach der public partial class Form1 : Form {-Anweisung verwenden, aber noch vor dem Konstruktor.
```
// 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

Freigeben über