Gewusst wie: Erstellen eines Windows Communication Foundation-ClientsHow to: Create a Windows Communication Foundation Client

Dies ist die vierte von sechs Aufgaben, die zum Erstellen einer Windows Communication Foundation (WCF)-Anwendung erforderlich sind.This is the fourth of six tasks required to create a Windows Communication Foundation (WCF) application. Eine Übersicht über alle sechs Aufgaben finden Sie im Artikel Getting Started Tutorial (Tutorial: Erste Schritte).For an overview of all six of the tasks, see the Getting Started Tutorial topic.

Dieses Thema beschreibt das Abrufen von Metadaten von einem WCF-Dienst aus, und verwenden, um einen WCF-Proxy zu erstellen, der den Dienst zugreifen können.This topic describes how to retrieve metadata from a WCF service and use it to create a WCF proxy that can access the service. Diese Aufgabe wird mithilfe der Hinzufügen eines Dienstverweises Funktionalität von Visual Studio.This task is completed by using the Add Service Reference functionality provided by Visual Studio. Dieses Tool ruft die Metadaten vom MEX-Endpunkt des Diensts ab und generiert eine verwaltete Quellcodedatei für einen Clientproxy in der von Ihnen ausgewählten Sprache (standardmäßig C#).This tool obtains the metadata from the service’s MEX endpoint and generates a managed source code file for a client proxy in the language you have chosen (C# by default). Zusätzlich zu dem Clientproxy erstellt oder aktualisiert das Tool die Clientkonfigurationsdatei, die es der Clientanwendung ermöglicht, über einen ihrer Endpunkte eine Verbindung mit dem Dienst herzustellen.In addition to creating the client proxy, the tool also creates or updates the client configuration file which enables the client application to connect to the service at one of its endpoints.

Hinweis

Sie können auch die ServiceModel Metadata Utility Tool (Svcutil.exe) Tool zum Generieren der Proxyklasse und Konfiguration anstelle von Hinzufügen eines Dienstverweises in Visual Studio.You can also use the ServiceModel Metadata Utility Tool (Svcutil.exe) tool to generate the proxy class and configuration instead of using Add Service Reference in Visual Studio.

Hinweis

Beim Aufrufen eines WCF-Diensts aus einem Klassenbibliotheksprojekt in Visual Studio können Sie die Hinzufügen eines Dienstverweises Funktion, um automatisch einen Proxy und eine zugeordnete Konfigurationsdatei zu generieren.When calling a WCF service from a class library project in Visual Studio, you can use the Add Service Reference feature to automatically generate a proxy and associated configuration file. Die Konfigurationsdatei wird nicht vom Klassenbibliotheksprojekt verwendet.The configuration file will not be used by the class library project. Sie müssen die Einstellungen in der generierten Konfigurationsdatei an der Datei "App.config" für die ausführbare Datei hinzufügen, die die Klassenbibliothek aufruft.You need to add the settings in the generated configuration file to the app.config file for the executable that calls the class library.

Die Clientanwendung verwendet die generierte Proxyklasse, um mit dem Dienst zu kommunizieren.The client application uses the generated proxy class to communicate with the service. Dieses Verfahren wird beschrieben, Vorgehensweise: Verwenden Sie einen Client.This procedure is described in How to: Use a Client.

So erstellen Sie einen Windows Communication Foundation-ClientTo create a Windows Communication Foundation client

  1. Erstellen Sie ein neues Konsolenanwendungsprojekt in Visual Studio.Create a new console application project in Visual Studio. Mit der rechten Maustaste auf die erste Schritte-Lösung im Projektmappen-Explorer , und wählen Sie hinzufügen > neues Projekt.Right-click on the Getting Started solution in Solution Explorer and select Add > New Project. In der neues Projekt hinzufügen im Dialogfeld auf der linken Seite, und wählen die Windows Desktop unter Kategorie Visual C#- oder Visual Basic.In the Add New Project dialog, on the left-hand side, select the Windows Desktop category under Visual C# or Visual Basic. Wählen Sie die Konsolen-App ((.NET Framework) Vorlage, und nennen Sie das Projekt "gettingstartedclient".Select the Console App (.NET Framework) template, and then name the project GettingStartedClient.

  2. Fügen Sie dem GettingStartedClient-Projekt einen Verweis auf den System.ServiceModel hinzu.Add a reference to System.ServiceModel to the GettingStartedClient project. Mit der rechten Maustaste auf die Verweise Ordner unter dem GettingStartedClient-Projekt in Projektmappen-Explorer, und wählen Sie dann Verweis hinzufügen.Right-click on the References folder under the GettingStartedClient project in Solution Explorer, and then select Add Reference. In der Verweis hinzufügen wählen Sie im Dialogfeld Framework auf der linken Seite des Dialogfelds unter Assemblys.In the Add Reference dialog, select Framework on the left-hand side of the dialog under Assemblies. Suchen und auswählen System.ServiceModel, und wählen Sie dann OK.Find and select System.ServiceModel, and then choose OK. Speichern Sie die Projektmappe durch Auswahl Datei > Alles speichern.Save the solution by selecting File > Save All.

  3. Fügen Sie einen Dienstverweis auf den Rechnerdienst hinzu.Add a service reference to the Calculator Service.

    1. Starten Sie die GettingStartedHost-Konsolenanwendung.First, start up the GettingStartedHost console application.

    2. Sobald der Host ausgeführt wird, mit der rechten Maustaste die Verweise Ordner unter dem GettingStartedClient-Projekt in Projektmappen-Explorer , und wählen Sie hinzufügen > Dienstverweis.Once the host is running, right-click the References folder under the GettingStartedClient project in Solution Explorer and select Add > Service Reference.

    3. Geben Sie die folgende URL in das Adressfeld ein, der die Hinzufügen eines Dienstverweises Dialogfeld: http://localhost:8000/GettingStartedClient/ServiceEnter the following URL in the address box of the Add Service Reference dialog: http://localhost:8000/GettingStartedClient/Service

    4. Wählen Sie wechseln.Choose Go.

    Der CalculatorService wird angezeigt, der Services Listenfeld.The CalculatorService is displayed in the Services list box. Doppelklicken Sie auf der CalculatorService zum Erweitern und die vom Dienst implementierten Dienstverträge anzuzeigen.Double-click CalculatorService to expand it and show the service contracts implemented by the service. Lassen Sie den Standardnamespace als-ist, und wählen Sie OK.Leave the default namespace as-is and choose OK.

    Wenn Sie einen Verweis auf einen Dienst mithilfe von Visual Studio hinzufügen, ein neues Element erscheint Projektmappen-Explorer unter der Dienstverweise Ordner unter dem GettingStartedClient-Projekt.When you add a reference to a service using Visual Studio, a new item appears in Solution Explorer under the Service References folder under the GettingStartedClient project. Bei Verwendung der ServiceModel Metadata Utility Tool (Svcutil.exe) Tool, eine Quellcodedatei und die Datei "App.config" generiert werden.If you use the ServiceModel Metadata Utility Tool (Svcutil.exe) tool, a source code file and app.config file are generated.

    Sie können auch das Befehlszeilentool ServiceModel Metadata Utility Tool (Svcutil.exe) mit den entsprechenden Schaltern, um den Clientcode zu erstellen.You can also use the command-line tool ServiceModel Metadata Utility Tool (Svcutil.exe) with the appropriate switches to create the client code. Im folgenden Beispiel werden eine Code- und eine Konfigurationsdatei für den Dienst erstellt:The following example generates a code file and a configuration file for the service. Das erste Beispiel zeigt, wie Sie den Proxy in VB generieren, und die zweite zeigt, wie in c# den Proxy zu generieren:The first example shows how to generate the proxy in VB, and the second shows how to generate the proxy in C#:

    svcutil.exe /language:vb /out:generatedProxy.vb /config:app.config http://localhost:8000/GettingStartedClient/service
    
    svcutil.exe /language:cs /out:generatedProxy.cs /config:app.config http://localhost:8000/GettingStartedClient/service
    

Nächste SchritteNext steps

Sie haben den Proxy erstellt, mit denen die Clientanwendung den rechnerdienst aufruft.You've created the proxy that the client application will use to call the calculator service. Fahren Sie mit dem nächsten Thema in der Reihe.Proceed to the next topic in the series.

Siehe auchSee also