MessageDistributionPolicy Enumeration

[This is prerelease documentation and is subject to change in future releases. Blank topics are included as placeholders.]

Indicates how messages are distributed when more than one subscriber is present for a router endpoint URI.

Namespace: Microsoft.ServiceBus
Assembly: Microsoft.ServiceBus (in microsoft.servicebus.dll)

Usage

    Dim instance As MessageDistributionPolicy

Syntax

'Declaration
<DataContractAttribute(Name:="MessageDistributionPolicy", Namespace:="https://schemas.microsoft.com/netservices/2009/05/servicebus/connect")> _
Public Enumeration MessageDistributionPolicy
[DataContractAttribute(Name="MessageDistributionPolicy", Namespace="https://schemas.microsoft.com/netservices/2009/05/servicebus/connect")] 
public enum MessageDistributionPolicy
[DataContractAttribute(Name=L"MessageDistributionPolicy", Namespace=L"https://schemas.microsoft.com/netservices/2009/05/servicebus/connect")] 
public enum class MessageDistributionPolicy
/** @attribute DataContractAttribute(Name="MessageDistributionPolicy", Namespace="https://schemas.microsoft.com/netservices/2009/05/servicebus/connect") */ 
public enum MessageDistributionPolicy
DataContractAttribute(Name="MessageDistributionPolicy", Namespace="https://schemas.microsoft.com/netservices/2009/05/servicebus/connect") 
public enum MessageDistributionPolicy

Members

Member name Description
AllSubscribers When a message is sent from the publisher to the router endpoint URI, then the message is distributed to all subscribers currently registered with the Router.
OneSubscriber When a message is sent from the publisher to the router endpoint URI, then the message is distributed to one of the subscribers currently registered with the Router. The system calculates a random number bounded by the number of subscribers and sends the message to the subscriber that has been picked. There is no guarantee for fair distribution of messages over a short period of time.

Remarks

Service Bus supports only Full Trust code access security.

This policy applies to an endpoint URI that is set up by a router. Based upon the setting, the message sent to the router URI would be forwarded to any one subscriber or all subscribers.

If the value is OneSubscriber, the system will randomly pick one of the concurrent subscribers and route the message to that subscriber. If the value is AllSubscribers, the message is routed to all subscribers that are subscribed to the router endpoint URI.

Platforms

Development Platforms

Windows XP Home Edition, Windows XP Professional, Windows Server 2003 , Windows Server 2008, and Windows 2000

Target Platforms

See Also

Reference

Microsoft.ServiceBus Namespace