How to: Select a Service Endpoint

  • Article

Some Windows Communication Foundation (WCF) services expose multiple endpoints through which a client may communicate with the service. For example, a service might expose one endpoint that uses an HTTP binding and user name / password security and a second endpoint that uses FTP and Windows Authentication. The first endpoint might be used by applications that access the service from outside a firewall, whereas the second might be used on an intranet.

In such a case, you can specify the endpointConfigurationName as a parameter to the constructor for a service reference.

Note

Your computer might show different names or locations for some of the Visual Studio user interface elements in the following instructions. The Visual Studio edition that you have and the settings that you use determine these elements. For more information, see Visual Studio Settings.

To select a service endpoint

  1. Add a reference to a WCF service. For more information, see How to: Add, Update, or Remove a Service Reference.

  2. In the Code Editor, add a constructor for the service reference:

    Dim proxy As New ServiceReference.Service1Client(

    ServiceReference.Service1Client proxy = new ServiceReference.Service1Client(

    Note

    Replace ServiceReference with the namespace for the service reference and replace Service1Client with the name of the service.

  3. An IntelliSense list will be displayed with the overloads for the constructor. Select the endpointConfigurationName As String overload.

  4. Following the overload, type = ConfigurationName, where ConfigurationName is the name of the endpoint that you want to use.

    Note

    If you do not know the names of the available endpoints, you can find them in the app.config file.

To find the available endpoints for a WCF service

  1. In Solution Explorer, right-click the app.config file for the project that contains the service reference and then click Open. The file will appear in the Code Editor.

  2. Search for the <Client> tag in the file.

  3. Search underneath the <Client> tag for a tag that starts with <Endpoint>.

    If the service reference provides multiple endpoints, there will be two or more <Endpoint tags.

  4. Inside the <EndPoint> tag you will find a name="SomeService" parameter (where SomeService represents an endpoint name). This is the name for the endpoint that can be passed to the endpointConfigurationName As String overload of a constructor for a service reference.

See Also

Tasks

How to: Add, Update, or Remove a Service Reference

Concepts

Windows Communication Foundation Services and WCF Data Services in Visual Studio

Other Resources

Consuming WCF Services in Visual Studio