共用方式為


雙工

雙面範例 (英文) 示範如何定義和實作雙面合約。 用戶端建立與服務的工作階段,並提供服務所需的通道以供服務將訊息傳回用戶端,這個程序即是所謂的雙工通訊。 這個範例以使用者入門為基礎。 雙工合約被定義為一對介面,其中的主要介面從用戶端到服務,回呼介面從服務到用戶端。 在此範例中,ICalculatorDuplex 介面允許用戶端執行數學運算,透過工作階段執行結果。 服務傳回 ICalculatorDuplexCallback 介面上的結果。 雙工合約需要一個工作階段,因為必須建立內容,將用戶端與服務之間傳送的訊息關聯在一起。

注意

此範例的安裝程序與建置指示位於本主題的結尾。

在這個範例中,用戶端是主控台應用程式 (.exe),而服務則是由網際網路資訊服務 (IIS) 所裝載。 雙工合約的定義如下:

[ServiceContract(Namespace = "http://Microsoft.ServiceModel.Samples", SessionMode=SessionMode.Required,
                 CallbackContract=typeof(ICalculatorDuplexCallback))]
public interface ICalculatorDuplex
{
    [OperationContract(IsOneWay = true)]
    void Clear();
    [OperationContract(IsOneWay = true)]
    void AddTo(double n);
    [OperationContract(IsOneWay = true)]
    void SubtractFrom(double n);
    [OperationContract(IsOneWay = true)]
    void MultiplyBy(double n);
    [OperationContract(IsOneWay = true)]
    void DivideBy(double n);
}

public interface ICalculatorDuplexCallback
{
    [OperationContract(IsOneWay = true)]
    void Result(double result);
    [OperationContract(IsOneWay = true)]
    void Equation(string eqn);
}

CalculatorService 類別會實作主要的 ICalculatorDuplex 介面。 服務會使用 PerSession 執行個體模式維持各工作階段的結果。 而名為 Callback 的私用屬性用於存取用戶端的回呼通道。 服務會使用回呼,以透過回呼介面將訊息傳回用戶端。

[ServiceBehavior(InstanceContextMode = InstanceContextMode.PerSession)]
public class CalculatorService : ICalculatorDuplex
{
    double result = 0.0D;
    string equation;

    public CalculatorService()
    {
        equation = result.ToString();
    }

    public void Clear()
    {
        Callback.Equation($"{equation} = {result}");
        equation = result.ToString();
    }

    public void AddTo(double n)
    {
        result += n;
        equation += $" + {n}";
        Callback.Result(result);
    }

    //...

    ICalculatorDuplexCallback Callback
    {
        get
        {
            return OperationContext.Current.GetCallbackChannel<ICalculatorDuplexCallback>();
        }
    }
}

用戶端必須提供實作雙工合約回呼介面的類別,用於接收來自服務的訊息。 在範例中,定義 CallbackHandler 類別以實作 ICalculatorDuplexCallback 介面。

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

   public void Equation(string equation)
   {
      Console.WriteLine("Equation({0}", equation);
   }
}

針對雙工合約所產生的 Proxy,會要求在建構時提供 InstanceContext。 這個 InstanceContext 會用來做為站台,讓物件實作回呼介面並處理服務傳回的訊息。 InstanceContext 是以 CallbackHandler 類別的執行個體所建構。 這個物件會處理回呼介面上,從服務傳回至用戶端的訊息。

// Construct InstanceContext to handle messages on callback interface.
InstanceContext instanceContext = new InstanceContext(new CallbackHandler());

// Create a client.
CalculatorDuplexClient client = new CalculatorDuplexClient(instanceContext);

Console.WriteLine("Press <ENTER> to terminate client once the output is displayed.");
Console.WriteLine();

// Call the AddTo service operation.
double value = 100.00D;
client.AddTo(value);

// Call the SubtractFrom service operation.
value = 50.00D;
client.SubtractFrom(value);

// Call the MultiplyBy service operation.
value = 17.65D;
client.MultiplyBy(value);

// Call the DivideBy service operation.
value = 2.00D;
client.DivideBy(value);

// Complete equation.
client.Clear();

Console.ReadLine();

//Closing the client gracefully closes the connection and cleans up resources.
client.Close();

組態已經過修改,以提供同時支援工作階段通訊和雙工通訊的繫結。 wsDualHttpBinding 支援工作階段通訊,並且藉由提供雙重 HTTP 連接 (一個方向一個連接) 允許雙工通訊。 在服務上,組態中的唯一差異是所使用的繫結。 在用戶端上,您必須設定伺服器可用來連接用戶端的位址,如下面的範例組態中所示。

<client>
  <endpoint name=""
            address="http://localhost/servicemodelsamples/service.svc"
            binding="wsDualHttpBinding"
            bindingConfiguration="DuplexBinding"
            contract="Microsoft.ServiceModel.Samples.ICalculatorDuplex" />
</client>

<bindings>
  <!-- Configure a binding that support duplex communication. -->
  <wsDualHttpBinding>
    <binding name="DuplexBinding"
             clientBaseAddress="http://localhost:8000/myClient/">
    </binding>
  </wsDualHttpBinding>
</bindings>

執行範例時,您會看到傳回用戶端的訊息,該用戶端位於從服務傳送出的回呼介面上。 顯示每個中繼結果,接著顯示在完成所有操作時的整個方程式。 按 ENTER 鍵關閉用戶端。

若要安裝、建置及執行範例

  1. 確定您已執行 Windows Communication Foundation 範例的一次性安裝程序

  2. 若要建置方案的 C#、C++ 或 Visual Basic .NET 版本,請遵循 建置 Windows Communication Foundation 範例 (部分機器翻譯) 中的指示。

  3. 若要在單一或多部電腦組態中執行此範例,請遵循執行 Windows Communication Foundation 範例中的指示進行。

    重要

    在跨電腦設定中執行用戶端時,請務必以適當電腦的名稱取代<用戶端>元素之<端點的 >address 屬性,以及 <wsDualHttpBinding> 元素之<繫結>元素 clientBaseAddress 屬性中的「localhost」,如下所示:

    <client>
        <endpoint name = ""
        address="http://service_machine_name/servicemodelsamples/service.svc"
        ... />
    </client>
    ...
    <wsDualHttpBinding>
        <binding name="DuplexBinding" clientBaseAddress="http://client_machine_name:8000/myClient/">
        </binding>
    </wsDualHttpBinding>