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.

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

15 Vorwort Vorwort Liebe Leserin, lieber Leser, vor Ihnen liegt unser neues "Visual C# 2005-Kochbuch", dessen Vorgänger sich nun schon fast drei Jahre erfolgreich auf dem Markt behauptet hat. Ergänzt wurde es um zahlreiche Rezepte, die sich vor allem auf die Neuerungen der.net-version 2.0 beziehen, andererseits wurden viele inzwischen veraltete Rezepte gestrichen bzw. grundlegend überarbeitet. Eingeflossen sind weiterhin die kritischen Hinweise unserer Leser zu den bis jetzt von uns veröffentlichten.net-büchern, die Erfahrungen von Lehrgängen und Workshops und last but not least die gesammelten Erkenntnisse unserer eigenen Programmiertätigkeit. Wir denken und hoffen, dass diese Fundamente so tragfähig sind, dass sie diesem Buch einen ähnlichen Erfolg bescheren wie auch seinem Vorgänger. Ist C# die richtige Sprache für Sie? Wenn Sie sich gerade für C# entschieden haben, dann haben Sie eine gute Wahl getroffen, denn C# ist das ideale Werkzeug zum Programmieren beliebiger.net-komponenten, angefangen bei einfachen Windows-Applikationen und lokalen Datenbankanwendungen bis hin zu Web- Anwendungen und XML-basierten Webdiensten. C# bietet Ihnen die Möglichkeiten und die Flexibilität von C++ und erlaubt trotzdem eine schnelle und unkomplizierte Programmierpraxis wie Visual Basic. C# ist genauso mächtig wie C++, wurde aber komplett neu auf objektorientierter Basis geschrieben. Ist dieses Buch genau das, was Sie suchen? Wahrscheinlich gehören auch Sie zum Kreis der angehenden oder gestandenen.net-programmierer, die es mittlerweile überdrüssig sind, ziel- und endlos in den zahlreichen Handbüchern oder Hilfedateien herumzustöbern, und die deshalb nach einem praxistauglichen Nachschlagewerk Ausschau halten, mit dem man 1. möglichst alle Fragen beantworten kann und 2. möglichst schnell das Gesuchte findet. Zum Punkt 1 müssen wir Sie leider enttäuschen ein derartiges "Großes Buch" gibt es bis heute noch nicht und wird es angesichts des gigantischen Füllhorns der.net-technologie, das Microsoft über uns ausgegossen hat, voraussichtlich auch niemals geben. Wir wollen uns aber im vorliegenden Buch bemühen, möglichst viele Lernbeispiele und Problemlösungen in allgemein verständlicher Form zu bringen, ohne dabei das zu wiederholen, was Ihnen die bereits etablierte

16 18 Vorwort Fachliteratur oder die zu Visual C# 2005 bzw. Visual Studio 2005 mitgelieferte Dokumentation ohnehin schon bietet. Bezüglich Punkt 2 sieht es da schon viel besser aus. Die einzelnen Rezepte des Kochbuchs sind in 11 Themengruppen übersichtlich angeordnet und mit treffsicheren Titeln ausgestattet. Der Index sollte ein Übriges dazu beitragen, schnell an die gewünschten Informationen zu kommen. Programmieren lernt man nur durch Beispiele! Die Grundphilosophie unserer Kochbücher, die auch zu verschiedenen anderen Programmiersprachen (Borland Delphi, Visual Basic) erschienen sind, basiert auf zwei Erkenntnissen: Programmieren lernt man nicht durch lineares Durcharbeiten eines Lehrbuchs, sondern nur nach dem "learning by doing"-prinzip, d.h. durch unermüdliches Ausprobieren von Beispielen, verbunden mit ständigem Nachschlagen in der Referenz. Diese Beispiele fügen sich erst nach längerer Zeit wie Mosaiksteinchen zu einer tragfähigen Basis. Umfang und Möglichkeiten einer.net-programmiersprache sind so gewaltig, dass jeder seriöse Titel das Prinzip der Vollständigkeit aufgeben muss und sich nach dem Prinzip "so viel wie nötig" lediglich eine "Initialisierungsfunktion" auf die Fahnen schreiben kann. Der inhaltliche Bogen der rund 400 Rezepte spannt sich vom simplen Einsteigerbeispiel bis hin zu anspruchsvollen Profi-Techniken und erfasst dabei, von sprachlichen Grundlagen über Steuerelemente, Grafik, Dateien und Datenbanken bis hin zu Druckersteuerung und Internetanwendungen so gut wie alle wesentlichen Einsatzgebiete der Windows- und Web-Programmierung mit Visual C# So hoffen wir, dass auch Sie der angebotene Breitband-Mix nicht enttäuschen wird und für jeden Ihrer Ansprüche etwas dabei ist. HINWEIS: Wer an fortgeschrittenen Techniken der.net-programmierung unter besonderer Berücksichtigung der Neuerungen in.net 2.0 interessiert ist, den verweisen wir auf unser Buch Visual C# 2005 für Profis (ISBN ). Ideal auch für Visual Basic-Umsteiger Das Pendant zum vorliegenden Buch ist unser ebenfalls bei Hanser erschienenes Visual Basic 2005-Kochbuch. Da beide Bücher exakt das gleiche Inhaltsverzeichnis haben (inkl. Beispielcode auf CD), lassen sich ideale Vergleiche zwischen beiden Sprachen anstellen. Eine solche "Übersetzungshilfe" ist besonders nützlich, weil einerseits viele altgediente Visual Basic-Programmierer zu C# wechseln und man andererseits in einem.net-entwicklerteam durchaus in mehreren.net-sprachen zusammenarbeitet.

17 Vorwort 19 Inhalt der Buch-CD Die zu diesem Buch mitgelieferte CD-ROM enthält den vollständigen Quellcode aller Rezepte. Auch alle benötigten Beispieldatenbanken sind mehrfach enthalten. Für den Einsteiger einige weitere Hinweise, die wir aufgrund von Erfahrungen mit unseren.net-vorgängertiteln diesmal nicht vergessen wollen: Sie sollten natürlich Visual Studio 2005 auf Ihrem PC installiert haben (diese Software befindet sich nicht auf der Buch-CD!). Wollen Sie direkt auf die Ordner zugreifen, dann klicken Sie auf das CD-Laufwerk mit der rechten Maustaste und wählen im Kontextmenü den Eintrag Öffnen. Kopieren Sie dann die gewünschten Dateien auf die Festplatte (falls Sie mit einem älteren Betriebssystem als Windows XP arbeiten, müssen Sie anschließend den Schreibschutz manuell entfernen). In der Regel sind alle von der Festplatte gestarteten Beispiele sofort lauffähig, da die Datenbanken meistens direkt in das Projektverzeichnis kopiert wurden, wodurch Probleme mit absoluten Pfadangaben entfallen. Für einige Beispiele ist eine Installation von SQL Server 2005 (SQLEXPRESS) erforderlich. Bei verteilten Anwendungen, insbesondere bei den Beispielen zu ASP.NET und XML-Webdiensten, ist besondere Aufmerksamkeit geboten (Reihenfolge der Installation der Clientund Server-Komponenten beachten, siehe beigefügte Liesmich-Dateien). Nobody is perfect... und so können auch die Autoren nicht ausschließen, dass sich auf fast 900 Seiten dieser oder jener Fehler eingeschlichen hat oder dass etwas sehr Wichtiges einfach vergessen wurde. Wenn Sie das "Haar in der Suppe" gefunden haben sollten wir sind für alle sachlich fundierten Hinweise und Kritiken dankbar! Richten Sie Ihr Feedback bitte an folgende Adresse: Aktuelle Hinweise, Fehlerberichtigungen etc. finden Sie auf unserer Homepage: Dank an alle Helfer und ein guter Rat für den Leser Beide Autoren wollen es nicht versäumen, sich bei ihren Familien wieder mal für eine mehrwöchige totale geistige Abwesenheit zu entschuldigen und sich mit einem großen Blumenstrauß für die über alle Maßen hinaus strapazierte Geduld und Nachsicht zu bedanken. Einen herzlichen Dank auch den netten Damen und Herren vom Carl Hanser Verlag, allen voran unserem tapferen und unbeugsamen Lektor Fernando Schneider, die uns zum richtigen Zeit-

18 20 Vorwort punkt ermutigt haben, den immer weiter aufquellenden Hefeteig endlich in die Backröhre zu schieben. Und zum Schluss ein gut gemeinter Rat an alle Leser: HINWEIS: Machen Sie beim Experimentieren möglichst viele Fehler denn nur so lernen Sie wirklich etwas! In diesem Sinne wünschen wir Ihnen neben dem notwendigen Stehvermögen auch zahlreiche freudige "Aha"-Erlebnisse auf Ihrem Weg zum erfolgreichen C#-Programmierer! Walter Doberenz und Thomas Gewinnus Altenburg und Frankfurt/O., im September 2006