Freigeben über

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

  • Artikel

In dieser Anleitung wird erläutert, wie eine Objektdatenquelle in einem Bericht in einer Microsoft Visual Studio 2008 ASP.NET-Anwendung verwendet wird. Weitere Informationen zu Geschäftsobjekten und Objektdatenquellen finden Sie unter Binden an Geschäftsobjekte.

Führen Sie die folgenden Schritte aus, um einem Visual Studio ASP.NET-Websiteprojekt einen Bericht hinzuzufügen. Bei diesem Beispiel erstellen Sie die Anwendung in Microsoft Visual C#.

Erstellen eines neuen ASP.NET-Websiteprojekts

  1. Zeigen Sie im Menü Datei auf Neu, und wählen Sie dann Website aus.

  2. Wählen Sie im Dialogfeld Neue Website Visual C# aus der Dropdownliste Sprache aus, und wählen Sie dann die Vorlage für eine ASP.NET-Website aus.

  3. Wählen Sie unter Speicherort die Option HTTP aus, und geben Sie die URL für die Website ein. Standardmäßig lautet die URL https://localhost/WebSite. Klicken Sie auf OK. Die Standardwebseite wird in der Codeansicht geöffnet.

Erstellen eines Geschäftsobjekts, das als Datenquelle verwendet wird

  1. Wählen Sie im Projektmappen-Explorer die Projektwebsite (beginnt mit http://) aus. Klicken Sie mit der rechten Maustaste, und wählen Sie Neues Element hinzufügen aus.

  2. 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.

  3. Wenn die Meldung "Möchten Sie die Klasse im Ordner 'App_Code' einfügen?" angezeigt wird, klicken Sie auf Ja. Die neue Datei wird dem Projekt hinzugefügt und automatisch in Visual Studio geöffnet.

  4. 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;
    }
}

  5. Wählen Sie im Menü Erstellen die Option Projektmappe erstellen aus. Hierdurch wird eine Assembly für das Objekt erstellt. Außerdem kann das Geschäftsobjekt Product im Fenster Website-Datenquellen angezeigt werden, nachdem Sie dem Projekt einen Bericht hinzugefügt haben.

Hinzufügen eines Berichts zum Projekt

  1. Stellen Sie sicher, dass die Projektwebsite oder ein Projektelement im Projektmappen-Explorer ausgewählt ist.

  2. Klicken Sie mit der rechten Maustaste auf die Projektwebsite, und wählen Sie Neues Element hinzufügen aus.

  3. 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 auf Hinzufügen. Der Bericht wird dem Projekt hinzugefügt und automatisch im Berichts-Designer geöffnet. Der Standardname für den Bericht lautet Report.rdlc.

Überprüfen des Fensters Website-Datenquellen

  1. Klicken Sie auf die Registerkarte Report.rdlc[Entwurf]. Klicken Sie im linken Bereich auf die Registerkarte Website-Datenquellen. Wenn die Registerkarte Website-Datenquellen nicht angezeigt wird, wählen Sie im Menü Daten den Befehl Datenquellen anzeigen aus.

  2. Überprüfen Sie, ob das Produktobjekt und die beiden öffentlichen Eigenschaften Name und Price in einer Hierarchie im Fenster Website-Datenquellen angezeigt werden.

Entwerfen des Berichts

  1. Ö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 Fenster Entwurf mit mehreren Registerkarten geöffnet.

  2. Ziehen Sie aus dem Fenster Website-Datenquellen das Namensfeld von der Produktdatenquelle in 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.

  3. Ziehen Sie das Feld Price in die Detailzeile der zweiten Spalte, sodass es sich neben dem Feld Namen befindet.

  4. Bei Bedarf können Sie die Kopfzeile der Tabelle markieren, indem Sie auf das linke Tabellenkopfsymbol klicken und den Schriftschnitt Fett anwenden.

  5. Löschen Sie die nicht verwendete Spalte. Klicken Sie auf die dritte Spalte, klicken Sie anschließend auf die Kopfzeilenleiste, und drücken Sie die ENTF-Taste.

  6. Um dem Bericht einen Titel hinzuzufügen, öffnen Sie die Toolbox und ziehen ein Textfeld auf den Bericht. Positionieren Sie das Textfeld oberhalb der Tabelle. Geben Sie Produkte als Berichtsnamen ein.

  7. Bei Bedarf können Sie einen Schriftgrad und einen Schriftschnitt für den Text festlegen, um den Titel hervorzuheben.

Hinzufügen eines ReportViewer-Steuerelements zur Webseite

  1. Wählen Sie die Standardwebseite in der Entwurfsansicht aus, indem Sie mit der rechten Maustaste im Projektmappen-Explorer auf Default.aspx klicken und anschließend Ansicht-Designer auswählen.

  2. Öffnen Sie die Toolbox. Erweitern Sie in der Toolbox den Knoten Daten, und ziehen Sie das Symbol ReportViewer auf die Webseite.

  3. Wählen Sie das ReportViewer-Steuerelement aus, und öffnen Sie 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 soeben entworfenen Bericht aus. Standardmäßig lautet der Name c:\inetpub\wwwroot\WebSite\\Report.rdlc. Beachten Sie, dass ein ObjectDataSource-Steuerelement unmittelbar unterhalb des ReportViewer-Steuerelements angezeigt wird und automatisch festgelegt wurde, dass der Inhalt von DataTable gemäß der Konfiguration in der Komponente TableAdapter der Datentabelle abgerufen wird.

Ausführen der Anwendung

  • Drücken Sie F5, um den Bericht mit aktiviertem Debuggen auszuführen, oder drücken Sie STRG+F5, um den Bericht ohne Debuggen auszuführen und anzuzeigen.

Siehe auch

Verweis

Microsoft.Reporting.WinForms.ReportViewer.Drillthrough
Microsoft.Reporting.WinForms.LocalReport.SubreportProcessing
Microsoft.Reporting.WebForms.ReportViewer.Drillthrough
Microsoft.Reporting.WebForms.LocalReport.SubreportProcessing

Konzepte

Verwenden des Smarttagbereichs ReportViewer-Aufgaben

Weitere Ressourcen

Beispiele und Anleitungen