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

Dies ist die vierte von sechs Aufgaben, die erforderlich sind, um einen Windows Communication Foundation (WCF)-Anwendung zu erstellen.This is the fourth of six tasks required to create a Windows Communication Foundation (WCF) application. Einen Überblick über alle sechs Aufgaben finden Sie unter der Lernprogramm für erste Schritte Thema.For an overview of all six of the tasks, see the Getting Started Tutorial topic.

In diesem Thema wird beschrieben, wie Metadaten von einem WCF-Dienst abrufen und verwenden, um einen WCF-Clientproxy 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. Für diese Aufgabe wird die Funktion Dienstverweis hinzufügen verwendet, die von Visual Studio bereitgestellt wird.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, um die Proxyklasse und die Konfiguration anstelle von Hinzufügen eines Dienstverweises in Visual Studio generieren.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 inside of Visual Studio.

Warnung

Beim Aufrufen eines WCF-Diensts aus einem Klassenbibliotheksprojekt in Visual Studio 2012Visual Studio 2012 können Sie das Hinzufügen eines Dienstverweises-Feature um automatisch einen Proxy und eine zugeordnete Konfigurationsdatei zu generieren.When calling a WCF service from a class library project in Visual Studio 2012Visual Studio 2012 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 der Datei app.config für die ausführbare Datei, die die Klassenbibliothek aufruft, die Einstellungen in der generierten Konfigurationsdatei hinzufügen.You will need to add the settings in the generated configuration file to the app.config file for the executable that will call 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. Hierin 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 mit der rechten Maustaste auf die erste Schritte-Projektmappe, wenn Sie auswählen, hinzufügen, neues Projekt.Create a new console application project by right-clicking on the Getting Started solution, selecting, Add, New Project. In der neues Projekt hinzufügen -Dialogfeld auf der linken Seite der Dialogfeld Select Windows unter c# oder VB.In the Add New Project dialog on the left hand side of the dialog select Windows under C# or VB. Wählen Sie im mittleren Abschnitt des Dialogfelds Konsolenanwendung.In the center section of the dialog select Console Application. Benennen Sie das Projekt mit GettingStartedClient.Name the project GettingStartedClient.

  2. Legen Sie das Zielframework des GettingStartedClient-Projekts auf .NET Framework 4.5 per Rechtsklick auf "gettingstartedclient" im Projektmappen-Explorer auswählen und Eigenschaften.Set the target framework of the GettingStartedClient project to .NET Framework 4.5 by right clicking on GettingStartedClient in the Solution Explorer and selecting Properties. Im Dropdownfeld mit der Bezeichnung Zielframework wählen .NET Framework 4.5.In the dropdown box labeled Target Framework select .NET Framework 4.5. Festlegen des Zielframeworks für ein VB-Projekt weicht etwas im Eigenschaftendialogfeld GettingStartedClient-Projekts klicken Sie auf die Kompilieren Registerkarte auf der linken Seite des Bildschirms, und klicken Sie dann auf die erweitert Kompilieren Sie die Optionen Schaltfläche auf der unteren linken Ecke des Dialogfelds.Setting the target framework for a VB project is a little different, in the GettingStartedClient project properties dialog, click the Compile tab on the left-hand side of the screen, and then click the Advanced Compile Options button at the lower left-hand corner of the dialog. Wählen Sie dann .NET Framework 4.5 im Dropdownfeld mit der Bezeichnung Zielframework.Then select .NET Framework 4.5 in the dropdown box labeled Target Framework.

    Festlegen des Zielframeworks führt dazu, dass Visual Studio 2011, laden Sie die Projektmappe erneut drücken OK Aufforderung.Setting the target framework will cause Visual Studio 2011 to reload the solution, press OK when prompted.

  3. Fügen Sie einen Verweis auf System.ServiceModel auf das Projekt "gettingstartedclient", indem Sie mit der rechten Maustaste die Verweis Ordner unter dem Projekt "gettingstartedclient" im Projektmappen-Explorer und wählen hinzufügen Verweis.Add a reference to System.ServiceModel to the GettingStartedClient project by right-clicking the Reference folder under the GettingStartedClient project in Solution Explorer and select Add Reference. In der Verweis hinzufügen Dialogfeld wählen Framework auf der linken Seite des Dialogfelds.In the Add Reference dialog select Framework on the left-hand side of the dialog. Geben Sie im Textfeld Assemblys suchenSystem.ServiceModel ein.In the Search Assemblies textbox, type in System.ServiceModel. Wählen Sie im mittleren Abschnitt des Dialogfelds System.ServiceModel, klicken Sie auf die hinzufügen aus, und klicken Sie auf die schließen Schaltfläche.In the center section of the dialog select System.ServiceModel, click the Add button, and click the Close button. Speichern Sie die Projektmappe, indem Sie auf die alle speichern Schaltfläche unterhalb des Hauptmenüs.Save the solution by clicking the Save All button below the main menu.

  4. Als Nächstes fügen Sie einen Dienstverweis auf den Rechnerdienst hinzu.Next you wlll add a service reference to the Calculator Service. Zuvor müssen Sie die GettingStartedHost-Konsolenanwendung starten.Before you can do that, you must start up the GettingStartedHost console application. Nachdem der Host ausgeführt wird können den Ordner "Verweise" unter dem Projekt "gettingstartedclient" im Projektmappen-Explorer mit der rechten Maustaste und wählen Sie Dienstverweis hinzufügen, und geben in der folgenden URL in das Adressfeld ein, der das Dialogfeld "Dienstverweis hinzufügen": HYPERLINK "http://localhost:8000/ServiceModelSamples/Service" http://localhost:8000/ServiceModelSamples/Service , und klicken Sie auf die Go Schaltfläche.Once the host is running you can right click the References folder under the GettingStartedClient project in the Solution Explorer and select Add Service Reference and type in the following URL in the address box of the Add Service Reference dialog: HYPERLINK "http://localhost:8000/ServiceModelSamples/Service" http://localhost:8000/ServiceModelSamples/Service and click the Go button. Anschließend wird im Listenfeld Dienste der CalculatorService angezeigt. Doppelklicken Sie auf CalculatorService, um den Dienst zu erweitern und die vom Dienst implementierten Dienstverträge anzuzeigen.The CalculatorService should then be displayed in the Services list box, Double click CalculatorService and it will expand and show the service contracts implemented by the service. Lassen Sie den Standardnamespace unverändert ist, und klicken Sie auf die OK Schaltfläche.Leave the default namespace as is and click the OK button.

    Wenn Sie mit Visual Studio einen Verweis auf einen Dienst hinzufügen, wird im Projektmappen-Explorer unter dem GettingStartedClient-Projekt unter dem Ordner Dienstverweise ein neuer Eintrag angezeigt.When you add a reference to a service using Visual Studio a new item will appear in the 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 will be generated.

    Sie können auch das Befehlszeilentool ServiceModel Metadata Utility Tool (Svcutil.exe) mit der entsprechenden Switches, 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. Im ersten Beispiel wird gezeigt, wie Sie den Proxy in VB generieren, und im zweiten Beispiel wird gezeigt, wie Sie den Proxy in C# generieren:The first example shows how to generate the proxy in VB and the second shows how to generated the proxy in C#:

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

Sie haben jetzt den Proxy erstellt, über den die Clientanwendung den Rechnerdienst aufruft.You have now created the proxy that the client application will use to call the calculator service. Fahren Sie mit dem nächsten Thema in der Reihe: Vorgehensweise: Konfigurieren eines ClientsProceed to the next topic in the series: How to: Configure a Client

Siehe auchSee Also

ServiceModel Metadata Utility-Tool (Svcutil.exe)ServiceModel Metadata Utility Tool (Svcutil.exe)
Erste SchritteGetting Started
Selbst gehostete DiensteSelf-Host
Vorgehensweise: Veröffentlichen von Metadaten für einen Dienst mithilfe einer KonfigurationsdateiHow to: Publish Metadata for a Service Using a Configuration File
Vorgehensweise: Verwenden von „Svcutil.exe“ zum Herunterladen von MetadatendokumentenHow to: Use Svcutil.exe to Download Metadata Documents