單向

這個範例示範具有單向服務作業的服務合約。與雙向服務作業的情況不同，用戶端不會等候服務作業完成。這個範例是以使用者入門範例為基礎，並且會使用 wsHttpBinding 繫結。這個範例中的服務是自我裝載的主控台應用程式，您可以用來觀察接收和處理要求的服務。用戶端也是主控台應用程式。

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

若要建立單向服務合約，請定義服務合約、將 OperationContractAttribute 類別套用至每一項作業，然後將 IsOneWay 設定為 true，如下列範例程式碼所示：

[ServiceContract(Namespace="http://Microsoft.ServiceModel.Samples")]
public interface IOneWayCalculator
{
    [OperationContract(IsOneWay=true)]
    void Add(double n1, double n2);
    [OperationContract(IsOneWay = true)]
    void Subtract(double n1, double n2);
    [OperationContract(IsOneWay = true)]
    void Multiply(double n1, double n2);
    [OperationContract(IsOneWay = true)]
    void Divide(double n1, double n2);
}

為了示範用戶端不等待服務作業完成的狀況，本範例中的服務程式碼實作了五秒鐘的延遲，如下列範例程式碼所示：

/ This service class implements the service contract.
// This code writes output to the console window.
 [ServiceBehavior(ConcurrencyMode = ConcurrencyMode.Multiple,    InstanceContextMode = InstanceContextMode.PerCall)]
public class CalculatorService : IOneWayCalculator
{
    public void Add(double n1, double n2)
    {
        Console.WriteLine("Received Add({0},{1}) - sleeping", n1, n2);
        System.Threading.Thread.Sleep(1000 * 5);
        double result = n1 + n2;
        Console.WriteLine("Processing Add({0},{1}) - result: {2}", n1, n2, result);
    }
    ...
}

當用戶端呼叫服務時，該呼叫會逕自傳回，而不等待服務作業完成。

當您執行範例時，用戶端與服務活動都會顯示在服務與用戶端主控台視窗中。您可以查看來自用戶端的服務接收訊息。請在每個主控台視窗中按下 ENTER，以關閉服務與用戶端。

用戶端會比服務先完成，表示用戶端不會等候單向服務作業完成。用戶端輸出如下：

Add(100,15.99)
Subtract(145,76.54)
Multiply(9,81.25)
Divide(22,7)

Press <ENTER> to terminate client.

服務輸出如下：

The service is ready.
Press <ENTER> to terminate service.

Received Add(100,15.99) - sleeping
Received Subtract(145,76.54) - sleeping
Received Multiply(9,81.25) - sleeping
Received Divide(22,7) - sleeping
Processing Add(100,15.99) - result: 115.99
Processing Subtract(145,76.54) - result: 68.46
Processing Multiply(9,81.25) - result: 731.25
Processing Divide(22,7) - result: 3.14285714285714

注意：

根據定義，HTTP 是一種要求/回應通訊協定；當要求提出時，就會傳回回應。即便是在 HTTP 上公開的單向服務作業，也是如此。呼叫作業時，服務會在服務作業執行以前傳回 202 的 HTTP 狀態碼。這個狀態碼表示已接受要求進行處理，但是處理尚未完成。呼叫此項作業的用戶端會封鎖，直到從服務收到 202 回應為止。當使用設定為使用工作階段的繫結來傳送多則單向訊息時，這可能會產生某種未預期的行為。根據預設，這個範例中使用的 wsHttpBinding 繫結會設定為使用工作階段，以便建立安全性內容。在預設情況下，將保證工作階段中的訊息依照傳送的順序抵達。因此，傳送工作階段中的第二則訊息時，就不會在第一則訊息處理完成之前加以處理。因此，除非完成處理上一則的訊息，否則，用戶端將不會收到訊息的 202 回應。所以用戶端會顯示為封鎖每次呼叫後續的作業。為了避免這種行為，此範例將執行階段設定為同時分派訊息至不同執行個體以進行處理。範例將 InstanceContextMode 設定為 PerCall，讓各則訊息可以分別由不同執行個體來處理。ConcurrencyMode 會設定為 Multiple，以允許多個執行緒同時分派訊息。

若要設定、建置及執行範例

1. 請確定您已執行 Windows Communication Foundation 範例的單次安裝程序。

2. 若要建置方案的 C# 或 Visual Basic .NET 版本，請遵循建置 Windows Communication Foundation 範例中的指示。

3. 若要在單一或跨電腦的組態中執行本範例，請遵循執行 Windows Communication Foundation 範例中的指示。

注意：
請先執行服務，然後才執行用戶端；先關閉用戶端，再關閉服務。這可以避免當用戶端因服務消失而無法正常關閉安全性工作階段時，所發生的用戶端例外狀況。

Send comments about this topic to Microsoft.
© 2007 Microsoft Corporation. All rights reserved.