How to: Access Services with a Duplex Contract

1. Create a service that contains two interfaces. The first interface is for the service, the second is for the callback. For more information about creating a duplex service, see How to: Create a Duplex Contract.

2. Run the service.

3. Use the ServiceModel Metadata Utility Tool (Svcutil.exe) to generate contracts (interfaces) for the client. For information about how to do this, see How to: Create a Windows Communication Foundation Client.

4. Implement the callback interface in the client class, as shown in the following example.

   C#

   Copy

   public class CallbackHandler : ICalculatorDuplexCallback
   {
       public void Result(double result)
       {
           Console.WriteLine("Result ({0})", result);
       }
       public void Equation(string equation)
       {
           Console.WriteLine("Equation({0})", equation);
       }
   }
   

   VB

   Copy

   Public Class CallbackHandler 
   Implements ICalculatorDuplexCallback
      Public Sub Result (ByVal result As Double)
         Console.WriteLine("Result ({0})", result)
      End Sub
       Public Sub Equation(ByVal equation As String)
           Console.Writeline("Equation({0})", equation)
       End Sub
   End Class
   
   

5. Create an instance of the InstanceContext class. The constructor requires an instance of the client class.

   C#

   Copy

   InstanceContext site = new InstanceContext(new CallbackHandler());
   

   VB

   Copy

   Dim site As InstanceContext = New InstanceContext(new CallbackHandler())
   

6. Create an instance of the WCF client using the constructor that requires an InstanceContext object. The second parameter of the constructor is the name of an endpoint found in the configuration file.

   C#

   Copy

   CalculatorDuplexClient wcfClient = 
   new CalculatorDuplexClient(site, "default")
   

   VB

   Copy

   Dim wcfClient As New CalculatorDuplexClient(site, "default")
   

7. Call the methods of the WCF client as required.

The following code example demonstrates how to create a client class that accesses a duplex contract.

Imports System
Imports System.ServiceModel

Namespace Microsoft.ServiceModel.Samples

    ' The service contract is defined in generatedClient.vb, generated from the service by the svcutil tool.

    ' Define class which implements callback interface of duplex contract
    Public Class CallbackHandler
        Implements ICalculatorDuplexCallback

        Public Sub Result(ByVal result As Double) Implements ICalculatorDuplexCallback.Result
            Console.WriteLine("Result({0})", result)
        End Sub

        Public Sub Equation(ByVal eqn As String) Implements ICalculatorDuplexCallback.Equation
            Console.WriteLine("Equation({0})", eqn)
        End Sub
    End Class

    Class Client
        Public Shared Sub Main()

            ' Construct InstanceContext to handle messages on callback interface
            Dim instanceContext As New InstanceContext(New CallbackHandler())

            ' Create a client
            Dim wcfClient As New CalculatorDuplexClient(instanceContext)
            Console.WriteLine("Press <ENTER> to terminate client once the output is displayed.")
            Console.WriteLine()

            Try
                ' Call the AddTo service operation.
                Dim value As Double = 100
                wcfClient.AddTo(value)

                ' Call the SubtractFrom service operation.
                value = 50
                wcfClient.SubtractFrom(value)

                ' Call the MultiplyBy service operation.
                value = 17.65
                wcfClient.MultiplyBy(value)

                ' Call the DivideBy service operation.
                value = 2
                wcfClient.DivideBy(value)

                ' Complete equation
                wcfClient.Clear()

                Console.ReadLine()

                'Closing the client gracefully closes the connection and cleans up resources
                wcfClient.Close()

            Catch timeout As TimeoutException
                Console.WriteLine(timeout.Message)
                wcfClient.Abort()
            Catch commException As CommunicationException
                Console.WriteLine(commException.Message)
                wcfClient.Abort()
            End Try
        End Sub

    End Class

End Namespace

Tasks

Concepts

Other Resources