Lektion 2: Erstellen einer Visual C#-Anwendung für die Kommunikation mit dem Webserver

In dieser Lektion erstellen Sie eine Visual C#-Anwendung für die Kommunikation mit dem Webserver.

Voraussetzungen

In dieser Lektion wird davon ausgegangen, dass Sie einen Webserver gemäß den Anweisungen in Lektion 1 eingerichtet haben. Siehe Lektion 1: Einrichten eines Webservers für den Empfang von SOAP-Anforderungen und das Senden von SOAP-Antworten.

Eine neue Version von Visual Studio ist erforderlich, um diese Lektion durchzuführen.

In dieser Lektion wird davon ausgegangen, dass Sie die Rollen und Privilegien haben, die im Abschnitt "Privilegien" am Anfang dieser praktischen Einführung aufgeführt sind: Praktische Einführung: Verwenden von Visual C# für den Zugriff auf einen SOAP/DISH-Webdienst.

Kontext und Bemerkungen

Diese Lektion enthält mehrere Verweise auf localhost. Verwenden Sie statt localhost den Hostnamen oder die IP-Adresse des Webservers aus Lektion 1, wenn der Webclient nicht auf demselben Computer ausgeführt wird wie der Webserver.

Dieses Beispiel verwendet Funktionen aus .NET Framework 2.0.

Aufgabe

Starten Sie Visual Studio.
Erstellen Sie ein neues Windows Forms-Anwendungsprojekt in Visual C#.

Ein leeres Formular wird angezeigt.
Fügen Sie dem Projekt einen Webverweis hinzu.
1. Klicken Sie auf Projekt » Dienstverweis hinzufügen.
2. Klicken Sie im Fenster "Dienstverweis hinzufügen" auf die Option Erweitert.
3. Klicken Sie im Fenster "Einstellungen für Dienstverweise" auf die Option Webverweis hinzufügen.
4. Geben Sie im Fenster "Webverweis hinzufügen" die Zeichenfolge http://localhost:8082/demo/SASoapTest_DNET in das Feld URL ein.
5. Klicken Sie auf Gehe zu (oder den grünen Pfeil).
  
  Visual Studio listet die im SASoapTest_DNET-Dienst verfügbare EmployeeList-Methode auf.
6. Klicken Sie auf Verweis hinzufügen.
  
  Visual Studio fügt localhost zum Projekt Webverweise im Fenster Projektmappen-Explorer hinzu.
Füllen Sie das leere Formular mit den gewünschten Objekte für die Webclient-Anwendung mit Daten.

Ziehen Sie im Fenster Toolbox die ListBox- und Button-Objekte in das Formular und aktualisieren Sie die Textattribute so, dass das Formular dem in der folgenden Darstellung ähnelt:

Schreiben Sie eine Prozedur, die auf den Webverweis zugreift und die verfügbaren Methoden verwendet.

Doppelklicken Sie auf die Schaltfläche Employee List und fügen Sie den folgenden Code für das Schaltflächenereignis "Click" hinzu:

int sqlCode;

listBox1.Items.Clear();

localhost.SASoapTest_DNET proxy = new localhost.SASoapTest_DNET();
DataSet results = proxy.EmployeeList(out sqlCode);
DataTableReader dr = results.CreateDataReader();

listBox1.BeginUpdate();
while (dr.Read())
{
    for (int i = 0; i < dr.FieldCount; i++)
    {
        string dataTypeName = dr.GetDataTypeName(i);
        string dataName = dr.GetName(i);
        System.Type ftype = dr.GetFieldType(i);
        System.TypeCode typeCode = System.Type.GetTypeCode(ftype);

        string columnName = "(" + dataTypeName + ")" + dataName + "=";

        if (dr.IsDBNull(i))
        {
            listBox1.Items.Add(columnName + "(null)");
        }
        else
        {
            switch (typeCode)
            {
                case System.TypeCode.Int32:
                    Int32 intValue = dr.GetInt32(i);
                    listBox1.Items.Add(columnName + intValue);
                    break;
                case System.TypeCode.Decimal:
                    Decimal decValue = dr.GetDecimal(i);
                    listBox1.Items.Add(columnName + decValue.ToString("c"));
                    break;
                case System.TypeCode.String:
                    string stringValue = dr.GetString(i);
                    listBox1.Items.Add(columnName + stringValue);
                    break;
                case System.TypeCode.DateTime:
                    DateTime dateValue = dr.GetDateTime(i);
                    listBox1.Items.Add(columnName + dateValue);
                    break;
                case System.TypeCode.Boolean:
                    Boolean boolValue = dr.GetBoolean(i);
                    listBox1.Items.Add(columnName + boolValue);
                    break;
                default:
                    listBox1.Items.Add(columnName + "(unsupported)");
                    break;
            }
        }
    }
    listBox1.Items.Add("");
}
listBox1.EndUpdate();
dr.Close();

Führen Sie die Anwendung aus.

Klicken Sie auf Debuggen » Debuggen starten.

Kommunizieren Sie mit dem Web-Datenbankserver.

Klicken Sie auf Employee List.

Das ListBox-Objekt zeigt die Ergebnismenge EmployeeList als (Typ)Name=Wert-Paare an. Die folgende Ausgabe zeigt wie ein Eintrag im ListBox-Objekt angezeigt wird:

(Int32)EmployeeID=102
(Int32)ManagerID=501
(String)Surname=Whitney
(String)GivenName=Fran
(Int32)DepartmentID=100
(String)Street=9 East Washington Street
(String)City=Cornwall
(String)State=NY
(String)Country=USA
(String)PostalCode=02192
(String)Phone=6175553985
(String)Status=A
(String)SocialSecurityNumber=017349033
(Decimal)Salary=$45,700.00
(DateTime)StartDate=8/28/1984 12:00:00 AM
(DateTime)TerminationDate=(null)
(DateTime)BirthDate=6/5/1958 12:00:00 AM
(Boolean)BenefitHealthInsurance=True
(Boolean)BenefitLifeInsurance=True
(Boolean)BenefitDayCare=False
(String)Sex=F

Der Salary-Betrag wird in das Währungsformat des Clients konvertiert.

Werten, die ein Datum ohne Uhrzeit enthalten, wird die Uhrzeit 00:00:00 oder Mitternacht zugewiesen (deren Anzeigeformat von den Sprachumgebungseinstellungen des Clients abhängt).

Werte, die NULL enthalten, werden mit der DataTableReader.IsDBNull-Methode getestet.

Ergebnisse

Die XML-Antwort vom Webserver enthält eine formatierte Ergebnismenge. Alle Spaltendaten werden in eine Zeichenfolgendarstellung der Daten konvertiert. Die folgende Ergebnismenge veranschaulicht wie Ergebnismengen formatiert werden, wenn sie an den Client gesendet werden:

<row>
 <EmployeeID>102</EmployeeID>
 <ManagerID>501</ManagerID>
 <Surname>Whitney</Surname>
 <GivenName>Fran</GivenName>
 <DepartmentID>100</DepartmentID>
 <Street>9 East Washington Street</Street>
 <City>Cornwall</City>
 <State>NY</State>
 <Country>USA</Country>
 <PostalCode>02192</PostalCode>
 <Phone>6175553985</Phone>
 <Status>A</Status>
 <SocialSecurityNumber>017349033</SocialSecurityNumber>
 <Salary>45700.000</Salary>
 <StartDate>1984-08-28</StartDate>
 <BirthDate>1958-06-05</BirthDate>
 <BenefitHealthInsurance>1</BenefitHealthInsurance>
 <BenefitLifeInsurance>1</BenefitLifeInsurance>
 <BenefitDayCare>0</BenefitDayCare>
 <Sex>F</Sex>
 </row>

Die DATATYPE ON-Klausel wurde in der vorherigen Lektion angegeben, um Datentypinformationen in der zurückgegebenen XML-Ergebnismenge zu generieren. Im Folgenden finden Sie ein Fragment aus der Antwort des Webservers. Die Typinformationen stimmen mit dem Datentyp der Datenbankspalten überein.

<xsd:element name='EmployeeID' minOccurs='0' type='xsd:int' />
<xsd:element name='ManagerID' minOccurs='0' type='xsd:int' />
<xsd:element name='Surname' minOccurs='0' type='xsd:string' />
<xsd:element name='GivenName' minOccurs='0' type='xsd:string' />
<xsd:element name='DepartmentID' minOccurs='0' type='xsd:int' />
<xsd:element name='Street' minOccurs='0' type='xsd:string' />
<xsd:element name='City' minOccurs='0' type='xsd:string' />
<xsd:element name='State' minOccurs='0' type='xsd:string' />
<xsd:element name='Country' minOccurs='0' type='xsd:string' />
<xsd:element name='PostalCode' minOccurs='0' type='xsd:string' />
<xsd:element name='Phone' minOccurs='0' type='xsd:string' />
<xsd:element name='Status' minOccurs='0' type='xsd:string' />
<xsd:element name='SocialSecurityNumber' minOccurs='0' type='xsd:string' />
<xsd:element name='Salary' minOccurs='0' type='xsd:decimal' />
<xsd:element name='StartDate' minOccurs='0' type='xsd:date' />
<xsd:element name='TerminationDate' minOccurs='0' type='xsd:date' />
<xsd:element name='BirthDate' minOccurs='0' type='xsd:date' />
<xsd:element name='BenefitHealthInsurance' minOccurs='0' type='xsd:boolean' />
<xsd:element name='BenefitLifeInsurance' minOccurs='0' type='xsd:boolean' />
<xsd:element name='BenefitDayCare' minOccurs='0' type='xsd:boolean' />
<xsd:element name='Sex' minOccurs='0' type='xsd:string' />

Spalten, die nur das Datum enthalten, werden in der XML-Antwort als yyyy-mm-dd formatiert.

Spalten, die nur die Uhrzeit enthalten, werden in der XML-Antwort als hh:mm:ss.nnn-HH:MM oder hh:mm:ss.nnn+HH:MM formatiert. An die Zeichenfolge wird ein Zeitzonen-Offset angehängt (-HH:MM oder +HH:MM).

Spalten, die sowohl das Datum als auch die Uhrzeit enthalten, werden in der XML-Antwort als yyyy-mm-ddThh:mm:ss.nnn-HH:MM oder yyyy-mm-ddThh:mm:ss.nnn+HH:MM formatiert. Das Datum wird durch den Buchstaben "T" von der Uhrzeit getrennt. An die Zeichenfolge wird ein Zeitzonen-Offset angehängt (-HH:MM oder +HH:MM).

Spalten, die Datum, Uhrzeit und Zeitzonen-Offset enthalten, werden in der XML-Antwort als yyyy-mm-ddThh:mm:ss.nnn-HH:MM oder yyyy-mm-ddThh:mm:ss.nnn+HH:MM formatiert. Das Datum wird durch den Buchstaben "T" von der Uhrzeit getrennt. An die Zeichenfolge wird ein Zeitzonen-Offset angehängt (-HH:MM oder +HH:MM).

Im Folgenden finden Sie einige Beispiele für einen Server, der in der Pazifik-Zeitzone läuft:

<ADate>2013-01-27</ADate>
<ATime>12:34:56.000-08:00</ATime>
<ADateTime>2013-01-27T12:34:56.000-08:00</ADateTime>
<ADateTimeWithZone>2013-01-27T12:34:56.000+06:00</ADateTimeWithZone>

Das Format, in der diese Datums- und Uhrzeitangaben in einer .NET-Anwendung angezeigt werden, hängt von der Zeitzone des Clients und Sprachumgebungseinstellungen ab. Im Folgenden finden Sie ein Beispiel für einen Client in der Eastern-Zeitzone mit einer US-Sprachumgebung (wobei davon ausgegangen wird, dass das heutige Datum der 28. Januar 2013 ist).

(DateTime)ADate=1/27/2013 12:00:00 AM 
(DateTime)ATime=1/28/2013 3:34:56 PM
(DateTime)ADateTime=1/27/2013 3:34:56 PM
(DateTime)ADateTimeWithZone=1/27/2013 1:34:56 AM

Beachten Sie, dass es keine separate Datums- und Uhrzeitangabe in der TypeCodeEnumeration gibt – es gibt nur TypeCode.DateTime. Dies erklärt, warum alle Ergebnisse das Datum und die Uhrzeit enthalten.

Die Datentypinformationen in der XML-Antwort für diese Datums- und Zeitangaben folgen:

<xsd:element name='ADate' minOccurs='0' type='xsd:date' />
<xsd:element name='ATime' minOccurs='0' type='xsd:time' />
<xsd:element name='ADateTime' minOccurs='0' type='xsd:dateTime' />
<xsd:element name='ADateTimeWithZone' minOccurs='0' type='xsd:dateTime' />

Kommentieren Sie diese Seite in DocCommentXchange.