Visual C# 2005 Kochbuch

Transkript

1 Produktinformation Seite 1 von Visual C# 2005 Kochbuch Walter Doberenz, Thomas Gewinnus ISBN Leseprobe Weitere Informationen oder Bestellungen unter sowie im Buchhandel

2 8 Reporting Services Kapitel 8 Reporting Services R8.1 Einen einfachen Bericht entwerfen In diesem Rezept wollen wir mit minimalem Aufwand einen Bericht auf Basis der relativ neuen XML-basierten Microsoft Reporting Services erstellen. Dabei ist in drei Schritten vorzugehen: Erzeugen einer Datenquelle Entwurf des Reports (.rdlc-datei) Verbinden des Reports mit einem ReportViewer Ziel unseres Beispiels ist die Ausgabe der "Kunden"-Tabelle aus der Datenbank Nordwind.mdb. Datenquelle erzeugen Nachdem Sie ein neues Projekt vom Typ Windows-Anwendung.geöffnet haben ziehen Sie per Drag & Drop die Datenbank Nordwind.mdb vom Windows-Explorer in den Projektmappen-Explorer (die Datenbank erscheint dort als kleine gelbe Tonne).

3 554 Kapitel 8: Reporting Services Der Assistent zum Konfigurieren von Datenquellen erscheint und fordert Sie zur Auswahl der Datenbankobjekte auf. Markieren Sie die Tabelle "Kunden", belassen Sie es bei Data- Set-Name = NordwindDataSet und klicken Sie auf die "Fertigstellen"-Schaltfläche. Report entwerfen Über das Menü Projekt/Neues Element hinzufügen... wählen Sie die Vorlage Bericht, wobei Sie den Standardnamen Report1.rdlc für die Reportdatei in Kunden.rdlc ändern sollten. Es erscheint der Report Designer, auf dessen Oberfläche Sie ein Element vom Typ Tabelle von der Toolbox absetzen. Falls die Toolbox nicht zu sehen ist, wählen Sie das Menü Ansicht/Toolbox.

4 R8.1 Einen einfachen Bericht entwerfen 555 Über das Menü Daten/Datenquellen anzeigen bringen wir das "Datenquellen"-Fenster zur Ansicht, in welchem unser typisiertes NorwindDataSet zu sehen sein müsste. Per Drag & Drop ziehen wir nun die gewünschten Kunden-Felder auf die "Detail"-Zeile (die mittlere Zeile) der Report-Tabelle, wobei die Kopfzeile automatisch ergänzt wird. Da eine Tabelle standardmäßig mit drei Spalten erzeugt wird, müssen wir über das Kontextmenü weitere Spalten hinzufügen: Formatieren Sie die Zellen der Report-Tabelle, z.b. die Schriftart, nach eigenem Ermessen über das Eigenschaftenfenster (F4) bzw. einen Eigenschaftendialog (Kontextmenü Eigenschaften). Die Spaltenbreite stellen Sie mit der Maus ein. Report mit ReportViewer verbinden Auf dem Startformular Form1 platzieren wir eine ReportViewer-Komponente aus der Daten- Sektion der Toolbox und setzen Sie die Dock-Eigenschaft auf Fill. Im Aufgaben-Menü der ReportViewer-Komponente wählen wir jetzt die Reportdatei Kunden.rdlc aus. In der Folge werden die Instanzen NordwindDataSet, KundenBindingSource und KundenTableAdapter erzeugt und im Komponentenfach sichtbar.

5 556 Kapitel 8: Reporting Services Der ReportViewer ist nun bereit für die Anzeige der Kunden-Tabelle. Starten Sie das Programm (F5). Während der mehr oder weniger langen Wartezeit erscheint eine animierte Meldung: Das Ergebnis:

6 R8.2 Einen Bericht ohne Assistentenhilfe erstellen 557 Über die Navigatorleiste haben Sie jetzt die Möglichkeit durch den Report zu blättern, den Report auszudrucken, die Seite einzurichten (z.b. Querformat), das Seitenlayout anzuzeigen, den Report im Excel oder PDF-Format zu exportieren, die Größe der Anzeige zu ändern oder nach Text zu suchen. R8.2 Einen Bericht ohne Assistentenhilfe erstellen Im Vorgängerrezept R8.1 "Einen einfachen Bericht entwerfen" hatten wir die Datenbindung des ReportViewers einem Assistenten überlassen und auch das typisierte DataSet NordwindDataSet wurde mit Assistentenhilfe generiert. Im vorliegenden Rezept wird das gleiche Problem in "Handarbeit" gelöst. Sie werden feststellen, dass der zusätzliche Aufwand gar nicht so groß ist und die Zusammenhänge dafür umso klarer hervortreten. NordwindDataSet im Xsd-Designer erzeugen Starten Sie eine neue Windows-Anwendung. Diesmal verzichten wir auf die Dienste des Assistenten zum Konfigurieren von Datenquellen und beschreiten einen anderen Weg, bei dem wir die Daten aus einer Xml-Datei laden werden. Über das Menü Projekt/Neues Element hinzufügen... fügen wir ein (typisiertes) DataSet hinzu und geben ihm den Namen NordwindDataSet.xsd. Es öffnet sich der Xsd-Designer. Klicken Sie auf die leere Fläche und fügen Sie per Kontextmenü eine neue DataTable hinzu:

7 558 Kapitel 8: Reporting Services Es dürfte für Sie kein Problem sein, die Tabelle umzubenennen und über das Hinzufügen- Kontextmenü mit Spalten (KundenCode, Firma, Kontaktperson, Funktion, Strasse, Ort...) und einem Primärschlüssel entsprechend der folgenden Abbildung auszustatten. Da der Datentyp aller Spalten standardmäßig System.String ist, brauchen wir in unserem Fall die Datentypen nicht zu ändern. Ein Klick auf das Menü Daten/Datenquellen anzeigen beweist, dass unser typisiertes DataSet jetzt als Datenquelle zur Verfügung steht:

8 R8.2 Einen Bericht ohne Assistentenhilfe erstellen 559 Bericht entwerfen Über das Menü Projekt/Neues Element hinzufügen... fügen Sie einen Bericht mit dem Namen Kunden.rdlc hinzu. Der Drag & Drop-Entwurf unterscheidet sich nicht vom Vorgängerrezept R8.1. Um aber keine Langeweile aufkommen zu lassen, wollen wir diesmal statt einer Tabelle eine Liste nehmen. Die Liste füllen wir mit Textfeldern entsprechend der Spaltenbreite aus und ziehen die entsprechenden Felder der "Kunden"-Tabelle hinein. Für die Spaltenüberschriften nehmen wir ebenfalls Textfelder, die wir diesmal aber per Hand mit der Spaltenüberschrift ausfüllen müssen. Zur optischen Trennung zwischen Liste und Listenkopf dient ein Linie- Element. ReportViewer anbinden Setzen Sie einen ReportViewer auf das Startformular Form1. Um ihn mit dem Report und mit der Datenquelle zu verbinden, benutzen wir diesmal allerdings nicht das Aufgaben-Menü des ReportViewers, sondern erledigen das per Code: using Microsoft.Reporting.WinForms; public partial class Form1 : Form { private void Form1_Load(object sender, EventArgs e) { Eine Instanz des typisierten DataSets erzeugen: NordwindDataSet nwds = new NordwindDataSet(); Anstatt aus der Datenbank Nordwind.mdb wollen wir das DataSet diesmal ressourcenschonend aus der Datei Kunden.xml laden, die sich im Anwendungsverzeichnis befindet (siehe Buch- CD): nwds.readxml("kunden.xml"); Eine BindingSource-Komponente für die Kunden-Tabelle erzeugen: BindingSource kundenbindingsource = new BindingSource(); kundenbindingsource.datasource = nwds; kundenbindingsource.datamember = "Kunden";

9 560 Kapitel 8: Reporting Services Eine Report-Datenquelle erzeugen, der im Konstruktor übergebene Namen entspricht der Bezeichnung im Dialog "Berichtsdatenquellen" (Menü Bericht/Datenquellen...) des Report- Designers: ReportDataSource rds1 = new ReportDataSource("NordwindDataSet_Kunden"); Der Report-Datenquelle die BindingSource zuweisen und zum Report hinzufügen: rds1.value = kundenbindingsource; reportviewer1.localreport.datasources.add(rds1); Den ReportViewer mit seiner Report-Ressource verbinden: } } reportviewer1.localreport.reportembeddedresource = "Test2.Kunden.rdlc"; this.reportviewer1.refreshreport(); Test Das Ergebnis ist die folgende Berichtsvorschau, wie sie im Wesentlichen dem Vorgängerrezept R8.1 entspricht:

10 R8.3 Im Bericht sortieren 561 R8.3 Im Bericht sortieren Dieses Rezept zeigt zwei Varianten, die zu einer sortierten Anzeige im Bericht führen. Neben der einfachen Lösung, bei der die Sortierfolge bereits zur Entwurfszeit einmalig fest eingestellt wird, zeigen wir, dass man unter Verwendung eines Parameters die Sortierfolge auch erst zur Laufzeit festlegen kann. Vorbereitungen Für den Reportentwurf muss eine Datenquelle NordwindDataSet mit der Tabelle "Bestellungen" zur Verfügung stehen. Das Befüllen dieser Tabelle mit Daten erfolgt nicht aus Nordwind.mdb, sondern aus einer Datei Bestellungen.xml, die sich im Anwendungsverzeichnis befindet (siehe R8.2). Oberfläche Auf dem Startformular Form1 finden ein ReportViewer und eine ComboBox ihren Platz. Füllen Sie die Items-Auflistung der ComboBox mit einigen KundenCodes., die später die Werte für den Parameter bereitstellen sollen. Fügen Sie einen Bericht Bestellungen.rdlc hinzu, den Sie mit einer Tabelle ausstatten. Feste Sortierfolge Das Einstellen einer festen Sortierfolge ist überhaupt kein Problem. Die Report-Steuerelemente Tabelle, ebenso wie Liste, verfügen über ein Kontextmenü Eigenschaften, mit welchem der mehrseitige Dialog "Tabelleneigenschaften" bzw. "Listeneigenschaften" aufgerufen wird. Auf der Seite "Sortierung" haben Sie die Möglichkeit, die Spalte(n) und die Richtungen festzulegen, nach denen sortiert werden soll.

11 562 Kapitel 8: Reporting Services Sortierfolge zur Laufzeit ändern Wollen Sie erst zur Laufzeit die Sortierfolge bestimmen, so kommen Sie nicht um die Definition eines Parameters herum. Öffnen Sie dazu den monströsen "Berichtsparameter"-Dialog (Menü Bericht/Berichtsparameter...). HINWEIS: Das Bericht-Menü steht nur bei geöffnetem Report-Designer zur Verfügung. Falls es dennoch fehlt, klicken Sie einfach auf die Oberfläche des Report-Designers. Tragen Sie rechts oben die Eigenschaften Name = prmsortfield und Datentyp = String ein und klicken Sie anschließend links unten die "Hinzufügen"-Schaltfläche. Öffnen Sie nun den Dialog "Tabelleneigenschaften" über das Eigenschaften-Kontextmenü der Tabelle und wählen Sie die Seite "Sortierung". In die Spalte "Ausdruck" tragen Sie diesmal jedoch keinen der per Klappbox angebotenen Werte ein (siehe oben), sondern öffnen den Ausdruckseditor. Tippen Sie den folgenden Ausdruck ein, der unter Benutzung der Switch-Funktion eine vom Wert des Parameters prmsortfield gesteuerteauswahl zwischen drei Sortiermöglichkeiten vornimmt:

12 R8.3 Im Bericht sortieren 563 Quellcode using Microsoft.Reporting.WinForms; public partial class Form1 : Form {... Beim Laden des Formulars werden die üblichen Routineaktivitäten durchgeführt: private void Form1_Load(object sender, EventArgs e) { NordwindDataSet nwds = new NordwindDataSet(); nwds.readxml("bestellungen.xml"); ReportDataSource rds1 = new ReportDataSource("NordwindDataSet_Bestellungen"); rds1.value = nwds.bestellungen; reportviewer1.localreport.datasources.add(rds1); reportviewer1.localreport.reportembeddedresource = "WindowsApplication1.Bestellungen.rdlc"; combobox1.selectedindex = 0; } Zum Kern des Rezepts kommen wir erst jetzt, denn der Parameter wird in der ComboBox ausgewählt und zugewiesen, anschließend wird die Report-Anzeige aktualisiert: } private void combobox1_selectedvaluechanged(object sender, EventArgs e) { ReportParameter[] prms = { new ReportParameter("prmSortField", combobox1.text) }; reportviewer1.localreport.setparameters(prms); this.reportviewer1.refreshreport(); }

13 564 Kapitel 8: Reporting Services Test R8.4 Im Bericht filtern Ein Bericht soll die von einem bestimmten Kunden aufgegebenen Bestellungen anzeigen, wobei vorher der KundenCode vom Anwender abzufragen ist. Außerdem soll es möglich sein nur die Bestellungen aufzurufen, deren Frachtkosten einen bestimmten Betrag überschreiten. Ähnlich wie beim Sortieren (siehe R8.3) haben wir hier zwei Möglichkeiten: unveränderliches Filter oder flexibles Filter unter Verwendunung eines Parameters. Letztere Variante soll Gegenstand dieses Rezepts sein. Oberfläche Auf dem Startformular Form1 finden ein ReportViewer, eine ComboBox und eine TextBox ihren Platz. Füllen Sie die Items-Auflistung der ComboBox mit einigen KundenCodes. Fügen Sie einen Bericht Bestellungen.rdlc hinzu, den Sie mit einem Textfeld und einer Tabelle ausstatten. Datenquelle Für den Reportentwurf muss eine Datenquelle NordwindDataSet mit der Tabelle "Bestellungen" zur Verfügung stehen. Das Befüllen dieser Tabelle mit Daten erfolgt aus einer Datei Bestellungen.xml, die sich im Anwendungsverzeichnis befindet (siehe R8.2). Parameterdefinition Zur Definition von Parametern dient der monströse "Berichtsparameter"-Dialog, den Sie über das Menü Bericht/Berichtsparameter... öffnen.