11 XML-Webdienste und das

Transkript

1 293 In diesem Kapitel lernen Sie wie Sie ein DataSet programmgesteuert erzeugen. wie Sie das DataSet in XML-Webdiensten nutzen können. wie Sie auf ein DataSet Filter anwenden. Die Klassenbibliothek des.net Frameworks beinhaltet die Klasse System.Data.DataSet, um relationale Daten im Speicher abzubilden. Ein DataSet ist normalerweise das Ergebnis einer SQL-Datenbankabfrage. Wenn Sie schon einmal ADO.NET genutzt haben, um auf eine Datenbank zuzugreifen, werden Sie dem DataSet schon begegnet sein. Vielleicht wissen Sie aber noch nicht, dass das DataSet auch außerhalb der Welt der Datenbanken eine ganze Reihe von Einsatzgebieten hat und dass XML-Webdienst-Projekte von den Features der DataSet-Klasse außerordentlich profitieren können. In diesem Kapitel geben wir Ihnen eine Einführung in die DataSet-Klasse und zeigen dabei deren Bedeutung in XML-Webdiensten. Um den Einsatz der DataSet-Klasse zu demonstrieren bauen wir auf das Beispiel aus Kapitel 10, Statusverwaltung auf, um ein nützlicheres und ausgereifteres Werkzeug zum Betrachten des Verlaufs der Anfragen nach einer Kreditkartennummern-Überprüfung zu erstellen. Überblick über das DataSet Eine umfassende Diskussion der DataSet-Klasse würde am Thema dieses Buches vorbeigehen. Daher geben wir Ihnen in diesem Abschnitt nur die Hintergrundinformationen über das DataSet, die notwendig sind, um den Rest des Kapitels zu verstehen. Sie sollten sich die Dokumentation des.net Framework SDKs ansehen, um genauere Informationen über die Klasse DataSet zu finden. Für unsere Zwecke können Sie sich die DataSet-Klasse so vorstellen, dass sie aus einer oder mehren Tabellen besteht, genauso wie in einer relationalen Datenbank. Jede Tabelle besteht aus Spalten und Zeilen. Die Spalten der Tabelle definieren, welche Art Daten die einzelnen Zel- 11 XML-Webdienste und das DataSet

2 Abbildung 11.1 Das DataSet len einer Zeile enthalten können. Eine Tabelle wird gefüllt, indem jeder Zeile der Tabelle Daten zugewiesen werden. In Abbildung 11.1 haben wir die Daten der Kreditkartenüberprüfung verwendet, um die Beziehungen zwischen Zeilen, Spalten, Tabellen und dem DataSet zu illustrieren. Dabei haben wir auch die Klassen des.net-frameworks angegeben, die für das Erzeugen der einzelnen Elemente zuständig sind. Kartentyp VISA AMEX MasterCard DataSet (System.Data.DataSet) Table (System.Data.DataTable) Column (System.Data.DataColumn) Spalte1 Zeile1 Zeile2 Zeile3 Kartennummer Spalte1 Zeile1 Zeile2 Zeile3 falsch 1234 Spalte2 Spalte2 Gültig True False False Spalte3 Row (System.Data.DataRow) Spalte3 Auch wenn das DataSet in den meisten Fällen dazu genutzt wird, um Daten einer relationalen Datenbank aufzunehmen, kann es doch auch dazu verwendet werden, um beliebige tabellarische Daten aufzunehmen. DataSet-Objekte sind nicht verbunden, d. h. es gibt keine geöffnete Verbindung zwischen der Datenbank und den Daten, die im DataSet enthalten sind. Das DataSet verhält sich wie eine einfache relationale Datenbank und kann unabhängig von den Originaldaten abgefragt und aktualisiert werden. Weil DataSet-Objekte nicht verbunden sind, werden Änderungen an einem DataSet nicht automatisch auch in die Datenbank übernommen. Ein DataSet merkt sich die Details aller Änderungen, aber diese Änderungen müssen erst explizit auf die Originaldatenbank so angewendet werden, wie es jeweils erforderlich ist, um auch dort diese Änderungen 294

3 295 vorzunehmen. Dieser Ansatz ist Ideal für XML-Webdienste, denn er gibt Ihnen die Möglichkeit, die Ergebnisse komplexer Abfragen zur Verarbeitung an Clients weiterzugeben. Clients können dann das DataSet verändern und zurückgeben, damit alle Änderungen auch in der Datenbank vollzogen werden können. Weil das DataSet nicht mit der Datenbank verbunden ist, muss der Client eines XML-Webdienstes nicht in der Lage sein, direkt mit der Datenbankanwendung zu kommunizieren. Weiter unten in diesem Kapitel werden wir einen XML-Webdienst erstellen, der ein DataSet programmgesteuert erstellt (also ohne Datenbank). Dieser Ansatz vereinfacht nicht nur das Projekt, das Sie erstellen werden (weil Sie keine SQL-Datenbank konfigurieren müssen), sondern er demonstriert auch deutlich, dass ein DataSet-Objekt auch ganz ohne Datenbank verwendet werden kann. Ein DataSet verwenden Im vorangegangenen Kapitel haben Sie den Webdienst zur Kreditkartennummern-Überprüfung um ein Feature ergänzt, mit dem der Verlauf der Überprüfungsanfragen aufgezeichnet wurde. Dieser Verlauf der Überprüfungsanfragen steht Clientanwendungen über die Methode GetValidationHistory zur Verfügung. In diesem Kapitel werden Sie diese Methode so umändern, dass der Anfrageverlauf als DataSet-Objekt zurückgegeben wird. Außerdem werden Sie eine Windows Forms- Clientanwendung erstellen, mit der der Benutzer selektiv Teile des Verlaufs betrachten kann. Es soll eine neue Methode mit dem Namen CreateDataSet erstellt werden, die als Argument ein ArrayList-Objekt erwartet, das aus ValidationObjects-Instanzen besteht, und die ein DataSet-Objekt mit dem Verlauf der Überprüfungsanfragen zurückgibt. Danach soll die Methode GetValidationHistory so abgeändert werden, dass sie das ArrayList- Objekt aus dem Anwendungsstatus ausliest und dann die neue Create- DataSet-Methode aufruft. Das erzeugte DataSet wird eine einzige Tabelle enthalten (mit dem Namen HistoryTable), die aus drei Spalten besteht: eine für den Kartentyp, eine für die Kartennummer und eine für das Ergebnis der Überprüfungsanfrage. Jedes ValidationObject in der ArrayList wird als Zeile dieser Tabelle dargestellt. Das folgende Diagramm (Abbildung 11.2) verdeutlicht die Struktur des DataSet-Objekts, das wir ValidationHistory genannt haben.

4 Abbildung 11.2 Der Aufbau des DataSets ValidationHistory DataSet (ValidationHistory) Table (HistoryTable) Die Spalten für Kartentyp, Kartennummer und das Ergebnis der Überprüfung Kartentyp VISA VISA AMEX Kartennummer Gültig True falsch False False Jede Zeile repräsentiert ein ValidationObject Das Projekt erstellen Q Öffnen Sie das Projekt, das Sie in Kapitel 10 erstellt haben. Der URL dieses Projekts sollte StateManagement/ValidatorService lauten. W Wählen Sie aus dem Menü Projekt den Befehl Projekt kopieren und kopieren Sie das Projekt in Kapitel11/DataSets/ValidatorService. E Öffnen Sie das neue Projekt in Visual Studio.NET und speichern Sie die Projektmappendatei des neuen Projekts. Aktualisieren der XML-Webdienst-Klasse Q Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf die Datei Validation.asmx und wählen Sie aus dem Kontextmenü den Befehl Code anzeigen. Damit wird die CodeBehind-Datei geöffnet, also entweder Validation.asmx.cs oder Validation.asmx.vb, je nachdem welche Programmiersprache Sie verwenden. W Fügen Sie in die Codedatei die nachfolgend aufgeführten Anweisungen ein, um die Methode CreateDataSet zu definieren. Die Methode CreateDataSet erzeugt das DataSet, das wir weiter oben beschrieben haben. Das DataSet wird mit diesen Anweisungen folgendermaßen erzeugt: Im ersten Schritt wird ein DateSet-Objekt mit dem Namen ValidationHistory angelegt. Danach wird ein neues DataTable-Objekt mit dem Namen History- Table erzeugt und zur Eigenschaft Tables des DataSet-Objekts hinzugefügt. 296

5 Anschließend werden neue DataColumn-Objekte für den Kartentyp, die Kartennummer und das Ergebnis der Überprüfungsanfrage erzeugt. Diese drei Spalten werden jeweils in die Tabelle eingefügt, die im vorhergehenden Teilschritt erzeugt wurden. Schließlich wird für jedes ValidationObject-Objekt in der ArrayList ein neues DataRow-Objekt erzeugt und in die DataTable eingefügt. Diese vier Teilschritte verdeutlichen, wie einfach es ist, ein DataSet- Objekt programmgesteuert zu erzeugen und mit Daten zu füllen und wie außerordentlich flexibel diese Klasse ist. Die Vorteile der Darstellung des Verlaufs der Überprüfungsanfragen in einer strukturierteren Art und Weise (im Vergleich zu dem mehrzeiligen String, der im letzten Kapitel verwendet wurde) werden deutlicher, wenn Sie weiter unten in diesem Kapitel den XML-Webdienst erstellen. Beachten Sie im Code außerdem, dass bei der Methode CreateDataSet kein WebMethod-Attribut verwendet wird. Diese Methode wird ausschließlich aus der Webdienst- Klasse selbst heraus aufgerufen und ihre Funktionalität braucht Clients nicht bereitgestellt werden. C# private DataSet CreateDataSet(ArrayList p_list) // Das DataSet erzeugen DataSet x_data_set = new DataSet("ValidationHistory"); // Das DataTable-Objekt erzeugen DataTable x_table = new DataTable("HistoryTable"); // Die Tabelle in das DataSet einfügen x_data_set.tables.add(x_table); // Die Spalten erstellen und in die Tabelle einfügen x_table.columns.add(new DataColumn("Kartentyp", typeof(string))); x_table.columns.add(new DataColumn("Kartennummer", typeof(string))); x_table.columns.add(new DataColumn("Gültig", typeof(bool))); // Die Einträge im ArrayList-Objekt durchgehen und // sie als Zeilen in die Tabelle einfügen foreach (ValidationObject x_object in p_list) // Zum Aufnehmen ein neues DataRow-Objekt erzeugen DataRow x_data_row = x_table.newrow(); // Festlegen der Daten in der Zeile mit // den Details des ValidationObject-Objekts x_data_row["kartentyp"] = x_object.o_card_type.tostring(); x_data_row["kartennummer"] = x_object.o_card_number; x_data_row["gültig"] = x_object.o_valid; 297

6 298 // Die Zeile in die Tabelle einfügen x_table.rows.add(x_data_row); // Das DataSet zurückgeben return x_data_set; Visual Basic.NET Private Function CreateDataSet(ByVal p_list As ArrayList) As DataSet ' Das DataSet erzeugen Dim x_data_set As DataSet = New DataSet("ValidationHistory") ' Das DataTable-Objekt erzeugen Dim x_table As DataTable = New DataTable("HistoryTable") ' Die Tabelle in das DataSet einfügen x_data_set.tables.add(x_table) ' Die Spalten erstellen und in die Tabelle einfügen x_table.columns.add(new DataColumn("Kartentyp", _ Type.GetType("System.String"))) x_table.columns.add(new DataColumn("Kartennummer", _ Type.GetType("System.String"))) x_table.columns.add(new DataColumn("Gültig", _ Type.GetType("System.Boolean"))) ' Die Einträge im ArrayList-Objekt durchgehen und ' sie als Zeilen in die Tabelle einfügen Dim x_object As ValidationObject For Each x_object In p_list ' Zum Aufnehmen ein neues DataRow-Objekt erzeugen Dim x_data_row As DataRow = x_table.newrow() ' Festlegen der Daten in der Zeile mit ' den Details des ValidationObject-Objekts x_data_row("kartentyp") = x_object.o_card_type.tostring() x_data_row("kartennummer") = x_object.o_card_number x_data_row("gültig") = x_object.o_valid ' Die Zeile in die Tabelle einfügen x_table.rows.add(x_data_row) Next ' Das DataSet zurückgeben Return x_data_set End Function E Ersetzen Sie die existierende Funktion GetValidationHistory durch den folgenden Code. Diese überarbeitete GetValidationHistory-Methode erhält zuerst die ArrayList aus ValidationObjects-Objekten, wozu sie die Unterstützung

7 299 des Anwendungsstatus nutzt, und ruft dann die Methode CreateDataSet auf, um das DataSet zu generieren und an den Client zu senden. C# [WebMethod] public DataSet GetValidationHistory() // Auslesen der Array-Liste aus dem Anwendungsstatus ArrayList x_list = (ArrayList)Application["ValidationObjects"]; // Prüfen, ob eine Liste vorhanden ist, mit der // gearbeitet werden kann. Wenn der Wert, der vom // Application-Objekt zurückgegeben wird NULL ist, // dann ist dies die erste Anfrage, die an die // XML-Webdienstmethode gerichtet wurde und die // Liste sollte für weitere Anfragen erzeugt werden. if (x_list == null) x_list = new ArrayList(); Application["ValidationObjects"] = x_list; // Erzeugen des DataSets aus der ArrayList // der ValidationObject-Objekte DataSet x_data = CreateDataSet(x_list); // Rückgabe der Verlaufsdaten return x_data; Visual Basic.NET <WebMethod()> _ Public Function GetValidationHistory() As DataSet ' Auslesen der Array-Liste aus dem Anwendungsstatus Dim x_list As ArrayList = _ CType(Application("ValidationObjects"), ArrayList) ' Prüfen, ob eine Liste vorhanden ist, mit der ' gearbeitet werden kann. Wenn der Wert, der vom ' Application-Objekt zurückgegeben wird NULL ist, ' dann ist dies die erste Anfrage, die an die ' XML-Webdienstmethode gerichtet wurde und die ' Liste sollte für weitere Anfragen erzeugt werden. If x_list Is Nothing Then x_list = New ArrayList()

8 300 Application("ValidationObjects") = x_list End If ' Erzeugen des DataSets aus der ArrayList ' der ValidationObject-Objekte Dim x_data As DataSet = CreateDataSet(x_list) ' Rückgabe der Verlaufsdaten Return x_data End Function R Erstellen Sie das Projekt, indem Sie entweder aus dem Menü Erstellen den Befehl Projektmappe erstellen auswählen oder indem Sie die Tastenkombination (Strg)+(ª)+(B) drücken. Erstellen des Windows Forms-Clients Der Windows Forms-Client, den Sie in diesem Kapitel brauchen, ist fast identisch mit dem, den Sie in Kapitel 10 im Abschnitt Das Windows Form erstellen erstellt haben. Sie brauchen ihn in diesem Kapitel lediglich dazu, um Einträge im Abfrageverlauf zu erhalten. Das Windows Form erstellen Q Kopieren Sie das Projekt mit der Clientvorlage in das Verzeichnis C:\Inetpub\wwwroot\XMLWebdiensteSfS\Kapitel10\StateManagement\, so wie wir es in Kapitel 7 im Abschnitt XML-Webdienstclient-Projekte beschrieben hatten. W Öffnen Sie das neue Clientprojekt mit Visual Studio.NET. E Öffnen Sie Form1 in der Entwurfsansicht. R Ändern Sie die Size-Eigenschaft von Form1 in 288; 272. T Fügen Sie die folgenden Steuerelemente in Form1 ein und konfigurieren Sie deren Eigenschaften anhand der folgenden Tabelle: Steuerelement Eigenschaft Wert Label Text TextAlign Location Size Gesamtanzahl der Anfragen: MiddleRight 48; ; 23

9 Abbildung 11.3 Die anpasste Oberfläche Steuerelement Eigenschaft Wert Label Text Löschen Sie den Inhalt des Eigenschaftswertes TextAlign MiddleLeft Name TotalRequests Location 200; 168 Size 70; 23 Label Text Ungültige Kartennummern insgesamt: TextAlign MiddleRight Location 4; 200 Size 194; 23 Label Text Löschen Sie den Inhalt des Eigenschaftswertes TextAlign MiddleLeft Name TotalInvalid Location 200; 200 Size 70; 23 Wenn Sie die Steuerelemente richtig eingefügt haben, sollte das Form ungefähr so aussehen: Einfügen des Webverweises ein, den Sie weiter oben in diesem Kapitel erstellt haben. Der URL für diesen Webdienst lautet (Wenn Sie nicht Q Fügen Sie den Webverweis zu dem XML-Webdienst ValidatorService 301

10 302 mehr genau wissen, wie Sie einen Webverweis hinzufügen, lesen Sie dies in Kapitel 4, Erstellen eines SOAP-Clients im Abschnitt Einen Webverweis erstellen nochmals nach). W Klicken Sie den Webverweis im Projektmappen-Explorer mit der rechten Maustaste an und wählen Sie aus dem Kontextmenü den Befehl Umbenennen. Nennen Sie den Webverweis Validator. Editieren des Codes Q Doppelklicken Sie im Designerfenster des Forms auf der Schaltfläche Überprüfen, damit Sie den Code ergänzen können, der ausgeführt wird, wenn der Benutzer die Schaltfläche anklickt. W Vervollständigen Sie die Methode ValidateButton_Click mit dem folgenden Code. Die Anweisungen, die dafür sorgen, dass die Statistiken vom XML- Webdienst angefordert werden, sind fett markiert. Die Methode ValidateButton_Click sendet nun zwei Anfragen an den XML-Webdienst: eine, um die Überprüfung der Nummer anzufordern (über die Methode ValidateCard) und eine zweite, um das ClientStats-Objekt zu erhalten (über die Methode GetClientStatistics). C# private void ValidateButton_Click(object sender, System.EventArgs e) // Erzeugen des ValidationObject-Objekts, das // an den XML-Webdienst gesendet wird ValidationObject x_object = new ValidationObject(); // Festlegen des Kartentyps des ValidationObject-Objekts // basierend auf der Auswahl des Benutzers im // Auswahlfeld CardType switch (CardType.Text) case "AMEX": x_object.o_card_type = CARD_TYPE.AMEX; break; case "MasterCard": x_object.o_card_type = CARD_TYPE.MASTERCARD; break; case "VISA": x_object.o_card_type = CARD_TYPE.VISA; break;

11 303 // Festlegen der Kartennummer im ValidationObject-Objekt x_object.o_card_number = CardNumber.Text; try o_service_validatecard(ref x_object); // Setzen des Textes im Egebnis-Label anhand der // Antwort des XML-Webdienstes if (x_object.o_valid) Result.Text = "Nummer gülitg"; else Result.Text = "Nummer ungültig"; catch (System.Web.Services.Protocols.SoapException x_ex) // Anzeige des Inhalts der Ausnahme switch (x_ex.code.tostring()) case "Client.IllegalCharacter": Result.Text = "Ungültiges Zeichen"; break; case "Client.InvalidLength": Result.Text = "Ungültige Länge"; break; case "Client.InvalidPrefix": Result.Text = "Ungültige Anfangszahlen"; break; default: Result.Text = "Unerwarteter Fehler"; break; // Anfordern der Clientstatistiken vom XML-Webdienst ClientStats x_state = o_service.getclientstatistics(); TotalRequests.Text = x_state.o_total_requests.tostring(); TotalInvalid.Text = x_state.o_failed_validations.tostring(); Visual Basic.NET Private Sub ValidateButton_Click(ByVal sender As Object, ByVal e _ As System.EventArgs) Handles ValidateButton.Click ' Erzeugen des ValidationObject-Objekts, das ' an den XML-Webdienst gesendet wird Dim x_object As ValidationObject = New ValidationObject()

12 ' Festlegen des Kartentyps des ValidationObject-Objekts ' basierend auf der Auswahl des Benutzers im ' Auswahlfeld CardType Select Case CardType.Text Case "AMEX" x_object.o_card_type = CARD_TYPE.AMEX Case "MasterCard" x_object.o_card_type = CARD_TYPE.MASTERCARD Case "VISA" x_object.o_card_type = CARD_TYPE.VISA End Select ' Festlegen der Kartennummer im ValidationObject-Objekt x_object.o_card_number = CardNumber.Text Try o_service.validatecard(x_object) ' Setzen des Textes im Egebnis-Label anhand der ' Antwort des XML-Webdienstes If x_object.o_valid Then Result.Text = "Nummer gültig" Else Result.Text = "Nummer ungültig" End If Catch x_ex As System.Web.Services.Protocols.SoapException Select Case x_ex.code.tostring() Case "Client.IllegalCharacter" Result.Text = "Ungültiges Zeichen" Case "Client.InvalidLength" Result.Text = "Ungültige Länge" Case "Client.InvalidPrefix" Result.Text = "Ungültige Anfangszahlen" Case Else Result.Text = "Unerwarteter Fehler" End Select End Try ' Anfordern der Clientstatistiken vom XML-Webdienst Dim x_state as ClientStats = o_service.getclientstatistics() TotalRequests.Text = x_state.o_total_requests.tostring() TotalInvalid.Text = x_state.o_failed_validations.tostring() End Sub E Ergänzen Sie die folgenden Anweisungen, um die Proxyklasse ValidatorService als eine Instanzvariable von Form1 zu definieren. 304

13 305 Diese Anweisungen sollten direkt unterhalb der Deklaration der Klasse Form1 eingefügt werden. Der folgende Auszug zeigt die Deklaration der Klasse Form1, wobei die Anweisungen fett markiert sind, mit denen die Instanzvariable definiert wird. C# public class Form1 : System.Windows.Forms.Form // Definition der Proxyklasse, die zum Konsumieren // des XML-Webdienstes verwendet wird private ValidatorService o_service; Visual Basic.NET Public Class Form1 Inherits System.Windows.Forms.Form ' Definition der Proxyklasse, die zum Konsumieren ' des XML-Webdienstes verwendet wird Private o_service as ValidatorService R Ergänzen Sie den Konstruktor der Klasse Form1 um die folgenden (fett markierten) Anweisungen. Mit diesen Anweisungen wird die Klasse ValidatorService zur Verwendung in der Methode ValidateButton_Click initialisiert. Wenn Sie in Visual Basic.NET programmieren, müssen Sie durch einen Klick auf das +-Zeichen den Bereich expandieren, der mit Vom Windows Form Designer generierter Code gekennzeichnet ist. C# public Form1() // // Erforderlich für die Windows Form-Designerunterstützung // InitializeComponent(); // Erzeugen des Proxyobjekts o_service = new ValidatorService(); // Festlegen des Cookie-Containers, damit das Proxyobjekt // in der Lage ist, das Cookie richtig zu verwenden, um // die Statusinformationen zu liefern o_service.cookiecontainer = new System.Net.CookieContainer(); // Abholen der Clientstatistik vom XML-Webdienst ClientStats x_state = o_service.getclientstatistics();

14 306 TotalRequests.Text = x_state.o_total_requests.tostring(); TotalInvalid.Text = x_state.o_failed_validations.tostring(); Visual Basic.NET Public Sub New() MyBase.New() ' Dieser Aufruf ist für den Windows Form-Designer erforderlich. InitializeComponent() ' Initialisierungen nach dem Aufruf InitializeComponent() hinzufügen ' Erzeugen des Proxyobjekts o_service = New ValidatorService() ' Festlegen des Cookie-Containers, damit das Proxyobjekt ' in der Lage ist, das Cookie richtig zu verwenden, um ' die Statusinformationen zu liefern o_service.cookiecontainer = New System.Net.CookieContainer() ' Abholen der Clientstatistik vom XML-Webdienst Dim x_state As ClientStats = o_service.getclientstatistics() TotalRequests.Text = x_state.o_total_requests.tostring() TotalInvalid.Text = x_state.o_failed_validations.tostring() End Sub T Erstellen Sie das Projekt, indem Sie entweder aus dem Menü Erstellen den Befehl Projektmappe erstellen auswählen oder indem Sie die Tastenkombination (Strg)+(ª)+(B) drücken. Konsumieren eines XML-Webdienstes, der ein DataSet verwendet Sie sollen nun eine Clientanwendung eines XML-Webdienstes erstellen, die die DataSet-Klasse nutzt, die durch die Webmethode GetValidation- History zurückgegeben wird. Wir sind weiter oben in diesem Kapitel schon kurz auf die Möglichkeiten eingegangen, wie ein DataSet-Objekt innerhalb eines XML-Webdienstes auch ohne eine dahinter liegende relationale Datenbank verwendet werden kann. Was wir noch nicht geklärt haben ist die Frage, warum Sie das denn überhaupt machen sollten. Die Antwort ist, dass einige der Komponenten der grafischen Benutzeroberflächen (Graphical User Interface, GUI) von WebForms und Windows Forms eine ausgesprochen umfangreiche Unterstützung für die Arbeit mit einem DataSet-Objekt bieten. Diese Komponenten ermöglichen es Ihnen, wesentlich ausgereiftere (und nützlichere) Clients zu erstellen, ohne dass Sie einen komplexeren XML-Webdienst erstellen

15 müssten. Eine der wichtigsten Klassen bei dieser Unterstützung ist die Klasse System.Data.DataView. Sie werden diese hier zum Erstellen eines Clients des XML-Webdienstes verwenden, der es dem Benutzer erlaubt, die Liste der Überprüfungsanfragen zu filtern, die vom XML- Webdienst geliefert wurde. Mit diesem Filter sollen nur noch die Anfragen für einen bestimmten Kartentyp angezeigt werden. In der Dokumentation zu Visual Studio.NET finden Sie genauere Informationen über die vielen anderen GUI-Komponenten, die mit dem DataSet-Objekt zusammenarbeiten können. Die Windowsanwendung erstellen dabei in C# oder in Visual Basic.NET die Vorlage Windowsanwendung. Nennen Sie dieses Projekt im Dialogfeld Neues Projekt ValidationHistoryClient und speichern Sie es im Verzeichnis C:\Inetpub\wwwroot\XML- WebdiensteSfS\Kapitel11\DataSets. Eigenschaft Wert Text Validation History Client Size 368; 320 deren Eigenschaften wie in der Tabelle angegeben. Steuerelement Eigenschaft Wert DataGrid CaptionText Abfrageverlauf ReadOnly True Name HistoryDataGrid RowHeadersVisible False Location 10; 10 PreferredColumnWidth 110 Size 340; 176 Label Text Filter: TextAlign MiddleRight Location 42; 202 Q Erstellen Sie ein neues Visual Studio.NET-Projekt und verwenden Sie W Ändern Sie die folgenden Eigenschaften von Form1. E Fügen Sie auf Form1 die folgenden Steuerelemente ein und ändern Sie 307

16 308 Steuerelement Eigenschaft Wert ComboBox Text Items Name Location Size Alle Alle AMEX VISA MasterCard FilterComboBox 178; ; 21 Button Text Name Location Size Verlauf abrufen HistoryButton 122; ; 32 Wenn Sie die Steuerelemente richtig hinzugefügt haben, sollte das Form aussehen, wie in Abbildung Einfügen des Webverweises Q Fügen Sie den Webverweis zu dem XML-Webdienst ValidatorService ein, den Sie weiter oben in diesem Kapitel erstellt haben. Der URL für diesen Webdienst lautet (Wenn Sie nicht mehr genau wissen, wie Sie einen Webverweis hinzufügen, lesen Sie dies in Kapitel 4, Erstellen eines SOAP-Clients im Abschnitt Einen Webverweis erzeugen nochmals nach). Abbildung 11.4 Das Windows Form

17 W Klicken Sie den Webverweis im Projektmappen-Explorer mit der rechten Maustaste an und wählen Sie aus dem Kontextmenü den Befehl Umbenennen. Nennen Sie den Webverweis Validator. Editieren des Codes Q Doppelklicken Sie im Designerfenster des Forms auf der Schaltfläche Verlauf abrufen, damit Sie den Code ergänzen können, der ausgeführt wird, wenn der Benutzer die Schaltfläche anklickt. Wenn die Schaltfläche Verlauf abrufen angeklickt wird, wird die Webmethode GetValidationHistory aufgerufen und ein DataSet zurückgegeben. Danach wird ein DataView-Objekt erzeugt, das dazu verwendet wird, die Daten, die dem Benutzer angezeigt werden, zu filtern. Die DataView-Klasse arbeitet mit einzelnen Tabellen eines DataSet-Objekts und daher wird die Eigenschaft DataSet.Tables genutzt, um auf die erste (und einzige) Tabelle zuzugreifen. Anschließend wird die Eigenschaft DataGrid.DataSource verwendet, um die Daten festzulegen, die das DataGrid-Steuerelement darstellen soll. Abschließend wird das Combo- Box-Steuerelement zurückgesetzt, sodass es wieder den Standardwert Alle anzeigt. C# private void HistoryButton_Click(object sender, System.EventArgs e) // Abrufen des DataSets vom XML-Webdienst DataSet x_set = new ValidatorService().GetValidationHistory(); // Erzeugen eines DataView-Objekts aus der Tabelle im DataSet DataView x_view = new DataView(x_set.Tables[0]); // Setzen der Datenquelle des DataGrid-Steuerelements // auf die neu erzeugte DataView HistoryDataGrid.DataSource = x_view; // Zurücksetzen der Auswahlliste auf "Alle" FilterComboBox.Text = "Alle"; Visual Basic.NET Private Sub HistoryButton_Click(ByVal sender As System.Object, _ ByVal e As System.EventArgs) Handles HistoryButton.Click ' Abrufen des DataSets vom XML-Webdienst Dim x_set As DataSet = New ValidatorService().GetValidationHistory() ' Erzeugen eines DataView-Objekts aus der Tabelle im DataSet Dim x_view As DataView = New DataView(x_set.Tables(0)) ' Festlegen der Datenquelle des DataGrid-Steuerelements ' auf die neu erzeugte DataView HistoryDataGrid.DataSource = x_view ' Zurücksetzen der Auswahlliste auf "Alle" FilterComboBox.Text = "Alle" End Sub 309

18 310 W Scrollen Sie an den Anfang der Codeansicht von Form1 und ergänzen Sie die folgende Anweisung, um den Namensraum der Proxyklasse zu importieren. C# // Import der Proxyklasse using ValidationHistoryClient.Validator; Visual Basic.NET ' Import der Proxyklasse Imports ValidationHistoryClient.Validator E Klicken Sie im Editor-Fenster auf die Registerkarte Form1.cs [Entwurf] (C#) bzw. Form1.vb [Entwurf] (Visual Basic.NET) und doppelklicken Sie auf das Auswahlfeld, damit Sie den Code editieren können, der ausgeführt wird, wenn der Benutzer einen Wert aus der Liste auswählt. Ergänzen Sie den folgenden Code, um die Methode FilterComboBox_SelectedIndexChanged zu komplettieren. C# private void FilterComboBox_SelectedIndexChanged(object sender, System.EventArgs e) // Auslesen der DataView aus dem DataGrid-Steuerelement DataView x_view = (DataView)HistoryDataGrid.DataSource; // Anwendung des Filters if (FilterComboBox.Text == "Alle") // Verwenden des Standardfilters, damit dem // Benutzer alle Daten angezeigt werden x_view.rowfilter = ""; else // Der Benutzer hat einen bestimmten Kartentyp // ausgewählt, der angezeigt werden soll. // Daher muss der Zeilenfilter entsprechend // gesetzt werden. x_view.rowfilter = "Kartentyp='" + FilterComboBox.Text + "'"; Visual Basic.NET Private Sub FilterComboBox_SelectedIndexChanged(ByVal sender As _ System.Object, ByVal e As System.EventArgs) _ Handles FilterComboBox.SelectedIndexChanged ' Auslesen der DataView aus dem DataGrid-Steuerelement Dim x_view As DataView = CType(HistoryDataGrid.DataSource, DataView) If (Not x_view Is Nothing) Then

19 311 ' Anwendung des Filters If FilterComboBox.Text = "All" Then ' Verwenden des Standardfilters, damit dem ' Benutzer alle Daten angezeigt werden x_view.rowfilter = "" Else ' Der Benutzer hat einen bestimmten Kartentyp ' ausgewählt, der angezeigt werden soll. ' Daher muss der Zeilenfilter entsprechend ' gesetzt werden. x_view.rowfilter = "Kartentyp='" + FilterComboBox.Text + "'" End If End If End Sub R Erstellen Sie das Projekt, indem Sie entweder aus dem Menü Erstellen den Befehl Projektmappe erstellen auswählen oder indem Sie die Tastenkombination (Strg)+(ª)+(B) drücken. Erzeugen der Überprüfungsanfragen Q Starten Sie die Clientanwendung. Starten Sie dazu den Windows Explorer und führen Sie die Clientanwendung aus, die Sie weiter oben in diesem Kapitel erzeugt haben. C#- Programmierer finden die Anwendung im Ordner C:\Inetpub\wwwroot\ XMLWebdiensteSfS\Kapitel11\DataSets\WindowsFormsClient\bin\ debug\windowsformsclient.exe; Visual Basic.NET-Programmierer finden sie unter C:\Inetpub\wwwroot\XMLWebdiensteSfS\Kapitel11\ DataSets\WindowsFormsClient\bin\WindowsFormsClient.exe. W Erzeugen Sie mit den Daten der folgenden Tabelle Anfragen an den XML-Webdienst, indem Sie jeweils den Kartentyp angeben, die Kartennummer eintippen und dann die Schaltfläche Überprüfen anklicken. Kartentyp Kartennummer VISA VISA AMEX MasterCard falsch Testen des XML-Webdienstclients Q Drücken Sie in Visual Studio.NET die Tastenkombination (Strg)+(F5), um die Anwendung Validation History Client zu starten. W Klicken Sie auf die Schaltfläche Verlauf abrufen.

20 312 Die Clientanwendung fordert damit das DataSet vom XML-Webdienst an und verwendet das DataGrid-Steuerelement, um den kompletten Satz mit den Details anzuzeigen, die Sie gerade eben eingegeben haben. In Abbildung 11.5 sehen Sie die Darstellung des Abfrageverlaufs. E Wählen Sie in der Auswahlliste den Wert VISA aus. Es werden nur die Anfragen zur Überprüfung von VISA-Kartennummern angezeigt, wie in Abbildung 11.6 zu sehen. R Wählen Sie in der Auswahlliste den Wert Alle aus. Abbildung 11.5 Der Abfrageverlauf Abbildung 11.6 Der gefilterte Verlauf

21 313 Es werden wieder alle Anfragen angezeigt, also auch die für die Überprüfung von MasterCard- und AMEX-Nummern. Über die Eigenschaft RowFilter der Klasse DataView können die Ergebnisse gefiltert werden, die im DataGrid-Steuerelement dargestellt werden. RowFilter ist dabei ein String, der aus einfachen SQL-Ausdrücken bestehen kann. Beispielsweise wird der Eigenschaft RowFilter in dem Fall, dass der Benutzer nur VISA-Karten sehen möchte, der folgende Wert zugewiesen: "Kartentyp='VISA'" Mit diesem Filter werden nur die Zeilen des DataTable-Objekts ausgewählt, in denen der Wert der Spalte Kartentyp VISA ist. Die Klasse DataView stellt sicher, dass im DataGrid-Steuerelement nur die Zeilen dargestellt werden, die zu diesem Filter passen. Auch wenn wir hier nur einen sehr einfachen Client erstellt haben, habe wir dem Benutzer zum Betrachten des Abfrageverlaufs trotzdem eine wesentlich bessere und ausgefeiltere Oberfläche bereitgestellt. Das DataView-Objekt versteckt alle Zeilen, die die Filterbedingungen nicht erfüllen, oder zeigt auch alle Anfragen an, was Sie sehen können, wenn Sie aus der Auswahlliste den Wert Alle auswählen. Die Daten werden clientseitig gefiltert, ohne dass weitere Anfragen an den XML-Webdienst gerichtet werden. Damit haben Sie eine Basis für ein einfaches und effizientes Datenmodell.

22 314 Kapitel 11 Schnellübersicht Um machen Sie Folgendes ein DataSet-Objekt in einem XML-Webdienst zu verwenden Ergänzen Sie Ihren XML-Webdienst um eine Methode, die ein DataSet-Objekt zurückgibt. Das.NET-Framework sorgt automatisch für alles, was für die Nutzung dieses DataSet-Objekt in einem XML-Webdienst nötig ist. Dadurch können relationale Daten nahtlos zwischen Webdiensten und Clients hin- und hergeschickt werden. einen Filter auf ein DataSet anzuwenden Verwenden Sie die RowFilter-Eigenschaft der Klasse DataView. ein DataSet-Objekt mittels Windows Forms-Komponenten darzustellen Nutzen Sie die Klasse DataGrid; setzen Sie eine Instanz der DataView-Klasse als deren DataSource-Eigenschaft fest, um eine Tabelle eines DataSet-Objekts darzustellen. Weitere Details zu diesen Klassen finden Sie in der Dokumentation zu Visual Studio.NET.