Gewusst wie: Konfigurieren eines grundlegenden Windows Communication Foundation-ClientsHow to: Configure a Basic Windows Communication Foundation Client

Dies ist die fünfte von sechs Aufgaben, die zum Erstellen einer grundlegenden Windows Communication Foundation (WCF)-Anwendung erforderlich sind.This is the fifth of six tasks required to create a basic 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 erläutert, die Clientkonfigurationsdatei, die generiert wurde, mit der Funktion "Dienstverweis hinzufügen" des Visual Studio 2012Visual Studio 2012 oder ServiceModel Metadata Utility Tool (Svcutil.exe).This topic discusses the client configuration file that was generated using the Add Service Reference functionality of Visual Studio 2012Visual Studio 2012 or the ServiceModel Metadata Utility Tool (Svcutil.exe). Für die Konfiguration des Clients muss der Endpunkt angegeben werden, den der Client verwendet, um auf den Dienst zuzugreifen.Configuring the client consists of specifying the endpoint that the client uses to access the service. Ein Endpunkt hat eine Adresse, eine Bindung und einen Vertrag. Bei der Konfiguration eines Clients muss jedes dieser Elemente angegeben werden.An endpoint has an address, a binding and a contract, and each of these must be specified in the process of configuring the client.

So konfigurieren Sie einen Windows Communication Foundation-ClientTo configure a Windows Communication Foundation client

  1. Öffnen Sie die generierte Konfigurationsdatei (App.config) aus dem GettingStartedClient-Projekt.Open the generated configuration file (App.config) from the GettingStartedClient project. Im folgenden Beispiel wird der Inhalt der generierten Konfiguration gezeigt.The following example is a view of the generated configuration file. Klicken Sie unter der <system.serviceModel > Abschnitt aus, suchen Sie die <Endpunkt > Element.Under the <system.serviceModel> section, find the <endpoint> element.

    <?xml version="1.0" encoding="utf-8" ?>  
    <configuration>  
        <startup>   
          <!-- specifies the version of WCF to use-->  
            <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.5,Profile=Client" />  
        </startup>  
        <system.serviceModel>  
            <bindings>  
                <!-- Uses wsHttpBinding-->  
                <wsHttpBinding>  
                    <binding name="WSHttpBinding_ICalculator" />  
                </wsHttpBinding>  
            </bindings>  
            <client>  
                <!-- specifies the endpoint to use when calling the service -->  
                <endpoint address="http://localhost:8000/ServiceModelSamples/Service/CalculatorService"  
                    binding="wsHttpBinding" bindingConfiguration="WSHttpBinding_ICalculator"  
                    contract="ServiceReference1.ICalculator" name="WSHttpBinding_ICalculator">  
                    <identity>  
                        <userPrincipalName value="migree@redmond.corp.microsoft.com" />  
                    </identity>  
                </endpoint>  
            </client>  
        </system.serviceModel>  
    </configuration>   
    

    In diesem Beispiel wird den Endpunkt, den der Client verwendet, um den Dienst zuzugreifen, der sich unter folgender Adresse befindet: http://localhost:8000/ServiceModelSamples/Service/CalculatorServiceThis example configures the endpoint that the client uses to access the service that is located at the following address: http://localhost:8000/ServiceModelSamples/Service/CalculatorService

    Das Endpunktelement gibt an, dass für die Kommunikation zwischen dem WCF-Client und dem Dienst der ServiceReference1.ICalculator-Dienstvertrag verwendet wird.The endpoint element specifies that the ServiceReference1.ICalculator service contract is used for communication between the WCF client and service. Der WCF-Kanal mit der vom System bereitgestellten konfiguriert ist < xref:System.ServiceModel.WsHttpBinding>.The WCF channel is configured with the system-provided < xref:System.ServiceModel.WsHttpBinding>. Dieser Vertrag wurde mithilfe der Visual Studio-Funktion Dienstverweis hinzufügen generiert.This contract was generated by using Add Service Reference in Visual Studio. Es handelt sich eigentlich um eine Kopie des Vertrags, der im GettingStartedLib-Projekt definiert wurde.It is essentially a copy of the contract that was defined in the GettingStartedLib project. Die < xref:System.ServiceModel.WsHttpBinding>-Bindung gibt HTTP als Transport, interoperable Sicherheit und weitere Einzelheiten der Konfiguration.The < xref:System.ServiceModel.WsHttpBinding> binding specifies HTTP as the transport, interoperable security, and other configuration details.

  2. Weitere Informationen zur Verwendung des generierten Clients mit dieser Konfiguration finden Sie unter Vorgehensweise: Verwenden Sie einen Client.For more information about how to use the generated client with this configuration, see How to: Use a Client.

Siehe auchSee Also

Verwenden von Bindungen, um Dienste und Clients zu konfigurierenUsing Bindings to Configure Services and Clients
ServiceModel Metadata Utility-Tool (Svcutil.exe)ServiceModel Metadata Utility Tool (Svcutil.exe)
Vorgehensweise: Erstellen eines ClientsHow to: Create a Client
Erste SchritteGetting Started
Selbst gehostete DiensteSelf-Host