How to: Specify a Client Binding in Code

In this example, a client is created to use a calculator service and the binding for that client is specified imperatively in code. The client accesses the CalculatorService, which implements the ICalculator interface, and both the service and the client use the BasicHttpBinding class.

This procedure assumes that the calculator service is running. For information about building the service, see How to: Specify a Service Binding in Configuration. It also uses the ServiceModel Metadata Utility Tool (Svcutil.exe) Windows Communication Foundation (WCF) provides to automatically generate the client components. The tool generates the client code for accessing the service.

The client is built in two parts. Svcutil.exe generates the ClientCalculator that implements the ICalculator interface. This client application is then constructed by constructing an instance of ClientCalculator and then specifying the binding and the address for the service in code.

For the source copy of this example, see the BasicBinding sample.

To specify a custom binding in code

1. Use Svcutil.exe from the command line to generate code from service metadata.

   Svcutil.exe <service's Metadata Exchange (MEX) address or HTTP GET address> 
   

2. The client that is generated contains the ICalculator interface that defines the service contract that the client implementation must satisfy.

   <ServiceContract()> _
   Public Interface ICalculator
   
       <OperationContract()> _
       Function Add(ByVal n1 As Double, ByVal n2 As Double) As Double
   
       <OperationContract()> _
       Function Subtract(ByVal n1 As Double, ByVal n2 As Double) As Double
   
       <OperationContract()> _
       Function Multiply(ByVal n1 As Double, ByVal n2 As Double) As Double
   
       <OperationContract()> _
       Function Divide(ByVal n1 As Double, ByVal n2 As Double) As Double
   
   End Interface
   

   [ServiceContract]
   public interface ICalculator
   {
      [OperationContract]
      double Add(double n1, double n2);
      [OperationContract]
      double Subtract(double n1, double n2);
      [OperationContract]
      double Multiply(double n1, double n2);
      [OperationContract]
      double Divide(double n1, double n2);
   }
   

3. The generated client also contains the implementation of the ClientCalculator.

   Public Class CalculatorClient
       Inherits System.ServiceModel.ClientBase(Of Microsoft.ServiceModel.Samples.ICalculator)
       Implements Microsoft.ServiceModel.Samples.ICalculator
   
       Public Sub New()
       End Sub
   
       Public Sub New(ByVal endpointConfigurationName As String)
           MyBase.New(endpointConfigurationName)
       End Sub
   
       Public Sub New(ByVal endpointConfigurationName As String, _
                      ByVal remoteAddress As String)
           MyBase.New(endpointConfigurationName, remoteAddress)
       End Sub
   
       Public Sub New(ByVal endpointConfigurationName As String, _
                      ByVal remoteAddress As EndpointAddress)
           MyBase.New(endpointConfigurationName, remoteAddress)
       End Sub
   
       Public Sub New(ByVal binding As Binding, _
                      ByVal remoteAddress As EndpointAddress)
           MyBase.New(binding, remoteAddress)
       End Sub
   
       Public Function Add(ByVal n1 As Double, _
                           ByVal n2 As Double) As Double Implements Microsoft.ServiceModel.Samples.ICalculator.Add
           Return MyBase.Channel.Add(n1, n2)
       End Function
   
       Public Function Subtract(ByVal n1 As Double, _
                                ByVal n2 As Double) As Double Implements Microsoft.ServiceModel.Samples.ICalculator.Subtract
           Return MyBase.Channel.Subtract(n1, n2)
       End Function
   
       Public Function Multiply(ByVal n1 As Double, _
                                ByVal n2 As Double) As Double Implements Microsoft.ServiceModel.Samples.ICalculator.Multiply
           Return MyBase.Channel.Multiply(n1, n2)
       End Function
   
       Public Function Divide(ByVal n1 As Double, _
                              ByVal n2 As Double) As Double Implements Microsoft.ServiceModel.Samples.ICalculator.Divide
           Return MyBase.Channel.Divide(n1, n2)
       End Function
   
   End Class
   

   public class CalculatorClient : System.ServiceModel.ClientBase<Microsoft.ServiceModel.Samples.ICalculator>, Microsoft.ServiceModel.Samples.ICalculator
   {
   
       public CalculatorClient()
       {
       }
   
       public CalculatorClient(string endpointConfigurationName) : 
               base(endpointConfigurationName)
       {
       }
   
       public CalculatorClient(string endpointConfigurationName, string remoteAddress) : 
               base(endpointConfigurationName, remoteAddress)
       {
       }
   
       public CalculatorClient(string endpointConfigurationName, EndpointAddress remoteAddress) : 
               base(endpointConfigurationName, remoteAddress)
       {
       }
   
       public CalculatorClient(Binding binding, EndpointAddress remoteAddress) : 
               base(binding, remoteAddress)
       {
       }
   
       public double Add(double n1, double n2)
       {
           return base.Channel.Add(n1, n2);
       }
   
       public double Subtract(double n1, double n2)
       {
           return base.Channel.Subtract(n1, n2);
       }
   
       public double Multiply(double n1, double n2)
       {
           return base.Channel.Multiply(n1, n2);
       }
   
       public double Divide(double n1, double n2)
       {
           return base.Channel.Divide(n1, n2);
       }
   }
   

4. Create an instance of the ClientCalculator that uses the BasicHttpBinding class in a client application, and then call the service operations at the specified address.

       'Client implementation code.
       Friend Class Client
           Shared Sub Main()
   
               'Specify the binding to be used for the client.
               Dim binding As New BasicHttpBinding()
   
               'Specify the address to be used for the client.
               Dim address As New EndpointAddress("https://localhost/servicemodelsamples/service.svc")
   
   
               ' Create a client that is configured with this address and binding.
               Dim client As New CalculatorClient(binding, address)
   
               ' Call the Add service operation.
               Dim value1 = 100.0R
               Dim value2 = 15.99R
               Dim result = client.Add(value1, value2)
               Console.WriteLine("Add({0},{1}) = {2}", value1, value2, result)
   
               ' Call the Subtract service operation.
               value1 = 145.0R
               value2 = 76.54R
               result = client.Subtract(value1, value2)
               Console.WriteLine("Subtract({0},{1}) = {2}", value1, value2, result)
   
               ' Call the Multiply service operation.
               value1 = 9.0R
               value2 = 81.25R
               result = client.Multiply(value1, value2)
               Console.WriteLine("Multiply({0},{1}) = {2}", value1, value2, result)
   
               ' Call the Divide service operation.
               value1 = 22.0R
               value2 = 7.0R
               result = client.Divide(value1, value2)
               Console.WriteLine("Divide({0},{1}) = {2}", value1, value2, result)
   
               'Closing the client gracefully closes the connection and cleans up resources
               client.Close()
   
               Console.WriteLine()
               Console.WriteLine("Press <ENTER> to terminate client.")
               Console.ReadLine()
           End Sub
       End Class
   End Namespace
   

       //Client implementation code.
       class Client
       {
           static void Main()
           {
   
               //Specify the binding to be used for the client.
               BasicHttpBinding binding = new BasicHttpBinding();
   
               //Specify the address to be used for the client.
               EndpointAddress address = 
                  new EndpointAddress("https://localhost/servicemodelsamples/service.svc");
   
   
               // Create a client that is configured with this address and binding.
               CalculatorClient client = new CalculatorClient(binding, address);
   
               // Call the Add service operation.
               double value1 = 100.00D;
               double value2 = 15.99D;
               double result = client.Add(value1, value2);
               Console.WriteLine("Add({0},{1}) = {2}", value1, value2, result);
   
               // Call the Subtract service operation.
               value1 = 145.00D;
               value2 = 76.54D;
               result = client.Subtract(value1, value2);
               Console.WriteLine("Subtract({0},{1}) = {2}", value1, value2, result);
   
               // Call the Multiply service operation.
               value1 = 9.00D;
               value2 = 81.25D;
               result = client.Multiply(value1, value2);
               Console.WriteLine("Multiply({0},{1}) = {2}", value1, value2, result);
   
               // Call the Divide service operation.
               value1 = 22.00D;
               value2 = 7.00D;
               result = client.Divide(value1, value2);
               Console.WriteLine("Divide({0},{1}) = {2}", value1, value2, result);
   
               //Closing the client gracefully closes the connection and cleans up resources
               client.Close();
   
               Console.WriteLine();
               Console.WriteLine("Press <ENTER> to terminate client.");
               Console.ReadLine();
           }
       }
   }
   
   

5. Compile and run the client.

See Also

Concepts

Using Bindings to Configure Services and Clients