Exemplarische Vorgehensweise: Erstellen von und Zugreifen auf WCF-Dienste

Článek
09/03/2008

Aktualisiert: Juli 2008

In dieser exemplarischen Vorgehensweise wird dargestellt, wie ein einfacher Windows Communication Foundation (WCF)-Dienst erstellt und getestet wird und wie er dann von einer Windows Forms-Anwendung verwendet werden kann.

Hinweis:
Ihr Computer zeigt möglicherweise für einige der Elemente der Visual Studio-Benutzeroberfläche in der folgenden Anleitung andere Namen oder Standorte an. Diese Elemente sind von der jeweiligen Visual Studio-Version und den verwendeten Einstellungen abhängig. Weitere Informationen finden Sie unter Visual Studio-Einstellungen.

Erstellen des Diensts

So erstellen Sie einen WCF-Dienst

Zeigen Sie im Menü Datei auf Neu, und klicken Sie dann auf Projekt.

Erweitern Sie im Dialogfeld Neues Projekt den Knoten Visual Basic oder Visual C#, klicken Sie auf WCF, und wählen Sie dann WCF-Dienstbibliothek aus. Klicken Sie auf OK, um das Projekt zu öffnen.

Hinweis:
Dadurch wird ein funktionierender Dienst erstellt, der tatsächlich getestet und auf den zugegriffen werden kann. Die folgenden beiden Schritte veranschaulichen, wie die Standardmethode für die Verwendung eines anderen Datentyps geändert werden kann. In einer realen Anwendung würden Sie dem Dienst auch eigene Funktionen hinzufügen.

Doppelklicken Sie im Projektmappen-Explorer auf IService1.vb oder IService1.cs, und suchen Sie die folgende Zeile:
```
Function GetData(ByVal value As Integer) As String
string GetData(int value);
```
Ändern Sie den Typ des value-Parameters in String.
```
Function GetData(ByVal value As String) As String
string GetData(string value);
```

Doppelklicken Sie im Projektmappen-Explorer auf Service1.vb oder Service1.cs, und suchen Sie die folgende Zeile:

Public Function GetData(ByVal value As Integer) As String _
Implements IService1.GetData
public string GetData(int value)

Ändern Sie den Typ des Wertparameters in String:

Public Function GetData(ByVal value As String) As String _
Implements IService1.GetData.
public string GetData(string value)

Testen des Diensts

So testen Sie einen WCF-Dienst

Drücken Sie F5 um den Dienst auszuführen. Es wird ein WCF-Testclient-Formular angezeigt, das den Dienst lädt.
Doppelklicken Sie im WCF-Testclient-Formular unter IService1 auf die GetData ()-Methode. Die Registerkarte GetData wird angezeigt.
Wählen Sie im Feld Anforderung das Feld Wert aus, und geben Sie Hello ein.
Klicken Sie auf die Schaltfläche Aufrufen. Wenn ein Dialogfeld Sicherheitswarnung angezeigt wird, klicken Sie auf OK. Das Ergebnis wird im Feld Antwort angezeigt.
Klicken Sie im Menü Datei auf Beenden, um das Testformular zu schließen.

Zugreifen auf den Dienst

So verweisen Sie auf einen WCF-Dienst

Zeigen Sie im Menü Datei auf Hinzufügen, und klicken Sie auf Neues Projekt.
Erweitern Sie im Dialogfeld Neues Projekt den Knoten Visual Basic oder Visual C#, wählen Sie Windows und dann Windows Forms-Anwendung aus. Klicken Sie auf OK, um das Projekt zu öffnen.
Klicken Sie mit der rechten Maustaste auf WindowsApplication1, und klicken Sie auf Dienstverweis hinzufügen. Das Dialogfeld Dienstverweis hinzufügen wird angezeigt.
Klicken Sie im Dialogfeld Dienstverweis hinzufügen auf Ermitteln.

Service1 wird im Bereich Dienste angezeigt.
Klicken Sie auf OK, um den Dienstverweis hinzuzufügen.

So erstellen Sie eine Clientanwendung

Doppelklicken Sie im Projektmappen-Explorer auf Form1.vb oder Form1.cs, um den Windows Forms-Designer zu öffnen, wenn er nicht bereits geöffnet ist.
Ziehen Sie aus der Toolbox ein TextBox-Steuerelement, ein Label-Steuerelement und ein Button-Steuerelement auf das Formular.

Doppelklicken Sie auf Button, und fügen Sie dem Click-Ereignishandler folgenden Code hinzu:

Private Sub Button1_Click(ByVal sender As System.Object, _
  ByVal e As System.EventArgs) Handles Button1.Click
    Dim client As New ServiceReference1.Service1Client
    Dim returnString As String

    returnString = client.GetData(TextBox1.Text)
    Label1.Text = returnString
End Sub
private void button1_Click(System.Object sender, System.EventArgs e)
{
    ServiceReference1.Service1Client client = new 
        ServiceReference1.Service1Client();
    string returnString;

    returnString = client.GetData(textBox1.Text);
    label1.Text = returnString;
}

Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf WindowsApplication1, und klicken Sie dann auf Als Startprojekt festlegen.
Drücken Sie F5, um das Projekt auszuführen. Geben Sie Text ein, und klicken Sie auf die Schaltfläche. Die Beschriftung lautet dann "You entered:" gefolgt von dem Text, den Sie eingegeben haben.

Siehe auch

Aufgaben

Beispiel zur Verwendung von ASMX- und WCF-Diensten

Änderungsprotokoll

Date	Versionsgeschichte	Grund
Juli 2008	Schritte und Code für C# hinzugefügt.	Informationsergänzung.

Sdílet prostřednictvím