IBindingDeliveryCapabilities.AssuresOrderedDelivery Property

Definition

Namespace:

System.ServiceModel.Channels

Assembly:

System.ServiceModel.Primitives.dll

Package:

System.ServiceModel.Primitives v8.1.0

Source:

IBindingDeliveryCapabilities.cs

Gets a value that indicates whether the binding can support assurances for the delivery of messages in the order they were sent.

public:
 property bool AssuresOrderedDelivery { bool get(); };

public bool AssuresOrderedDelivery { get; }

member this.AssuresOrderedDelivery : bool

Public ReadOnly Property AssuresOrderedDelivery As Boolean

Property Value

Boolean

true if messages must be delivered in the order in which they were sent; false, if the messages might not be delivered in this order.

Examples

The following sample requires that CalculatorService must use a WSHttpBinding with ordered message delivery. Reliable sessions and queued delivery are not used by default with this binding, but can be enabled.

<!-- Here is the configuration for a CalculatorService using a WSHttpBinding with ordered message delivery required. -->  
<?xml version="1.0" encoding="utf-8" ?>  
<configuration>  
   <system.serviceModel>  
      <services>  
         <service   
             type="Microsoft.ServiceModel.Samples.CalculatorService">  
            <!-- Use base address provided by host and a WSHttpBinding named "Binding1" -->  
            <endpoint address=""  
                      binding="wsHttpBinding"  
                      bindingConfiguration="Binding1"   
                      contract="Microsoft.ServiceModel.Samples.ICalculator" />  
         </service>  
      </services>  

      <bindings>  
         <wsHttpBinding>   
            <binding name="Binding1">           
               <!-- The next element enables a ReliableSession and required ordered delivery-->  
      <reliableSession enabled="true" ordered="true"/>  
      </binding>  
         </wsHttpBinding>  
      </bindings>  

   </system.serviceModel>  
</configuration>  

// The CalculatorService configuration has enabled a reliable session  
// with ordered delivery set to true. This means that the binding  
// requirement for ordered delivery specified by the  
// BindingRequirementsAttribute on the CalculatorService class  
// implemented below will be satisfied by this WSHttpBinding.  

using System;  
using System.ServiceModel;  

[ServiceContract]  
interface ICalculatorService  
{  
  [OperationBehavior()]  
  int Add(int a, int b);    

  [OperationContract]  
  int Subtract(int a, int b);  
}  

[BindingRequirements(  
  QueuedDeliveryRequirements=RequirementsMode.Disallow,  
  RequireOrderedDelivery=true  
)]  
class CalculatorService: ICalculatorService  
{  
  public int Add(int a, int b)  
  {  
    Console.WriteLine("Add called.");  
    return a + b;   
  }  

  public int Subtract(int a, int b)  
  {  
    Console.WriteLine("Subtract called.");  
    return a - b;  
  }  

  public int Multiply(int a, int b)  
  {  
    return a * b;  
  }  
}  

Remarks

The value of this AssuresOrderedDelivery property is consumed by the RequireOrderedDelivery when the description of the service is loaded at runtime. This check is done to determine whether the ordered delivery requirements of the service are satisfied by the binding selected or created for the service.