雙工服務

發行項
09/12/2008

雙工服務合約為訊息交換模式，其中的兩個端點可以彼此獨立地傳送訊息。因此，雙工服務可以將訊息傳送回用戶端端點，以提供類似事件的行為。用戶端建立與服務的連線，並提供服務所需的通道以供服務將訊息傳回用戶端，這個程序即是所謂的雙工通訊。請注意，雙工服務的類似事件行為只會在工作階段內運作。

若要建立雙工合約，您可建立一組介面。第一個是服務合約介面，說明用戶端可叫用的作業。該服務合約必須在 System.ServiceModel.ServiceContractAttribute.CallbackContract 屬性中指定「回呼合約」(Callback Contract)。回呼合約是一個介面，會定義服務可在用戶端端點上呼叫的作業。雙工合約不需要工作階段，不過系統提供的雙工繫結會利用工作階段。

以下為雙工合約的範例。

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

用戶端必須提供實作雙工合約回呼介面的類別，用於接收來自服務的訊息。以下範例程式碼將示範實作 ICalculatorDuplexCallback 介面的 CallbackHandler 類別。

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

服務的組態必須進行設定，以提供同時支援工作階段通訊和雙工通訊的繫結。wsDualHttpBinding 項目支援工作階段通訊，並且藉由提供雙重 HTTP 連接 (一個方向一個連接) 允許雙工通訊。

在用戶端上，您必須設定伺服器可用來連接用戶端的位址，如下面的範例組態中所示。

注意：
無法使用安全對話來進行驗證的非雙工用戶端通常會擲回 MessageSecurityException。不過，如果使用安全對話的雙工用戶端驗證失敗，則用戶端會收到 TimeoutException。

如果您使用 WSHttpBinding 項目建立用戶端/服務，但是未包含用戶端回呼端點，則會收到以下錯誤。

HTTP could not register URL
htp://+:80/Temporary_Listen_Addresses/<guid> because TCP port 80 is being used by another application.

以下範例程式碼將示範如何在程式碼中指定用戶端端點位址。

WSDualHttpBinding binding = new WSDualHttpBinding();
EndpointAddress endptadr = new EndpointAddress("https://localhost:12000/DuplexTestUsingCode/Server");
binding.ClientBaseAddress = new Uri("https://localhost:8000/DuplexTestUsingCode/Client/");

以下範例程式碼將示範如何在組態中指定用戶端端點位址。

<client>
    <endpoint name ="ServerEndpoint" 
          address="https://localhost:12000/DuplexTestUsingConfig/Server"
          bindingConfiguration="WSDualHttpBinding_IDuplexTest" 
            binding="wsDualHttpBinding"
           contract="IDuplexTest" />
</client>
<bindings>
    <wsDualHttpBinding>
        <binding name="WSDualHttpBinding_IDuplexTest"  
          clientBaseAddress="https://localhost:8000/myClient/" >
            <security mode="None"/>
         </binding>
    </wsDualHttpBinding>
</bindings>

請參閱

共用方式為

雙工服務

請參閱

工作

概念

其他資源

其他資源