SubscriptionClient.AddRule Method

Definition

Namespace:

Microsoft.ServiceBus.Messaging

Assembly:

Microsoft.ServiceBus.dll

Package:

WindowsAzure.ServiceBus v6.2.2

Overloads

AddRule(RuleDescription)	Adds a new rule to the SubscriptionDescription using the specified rule description.
AddRule(String, Filter)	Adds a rule to the current subscription with the specified name and filter expression.

AddRule(RuleDescription)

Adds a new rule to the SubscriptionDescription using the specified rule description.

public void AddRule (Microsoft.ServiceBus.Messaging.RuleDescription description);

member this.AddRule : Microsoft.ServiceBus.Messaging.RuleDescription -> unit

Public Sub AddRule (description As RuleDescription)

Parameters

description

RuleDescription

The rule description that provides metadata of the rule to add.

Exceptions

ArgumentNullException

Thrown if description is null.

ArgumentException

Thrown if description.Name.Name is null, white space empty or not in the right format.

ArgumentOutOfRangeException

Thrown if description.Name.Name length has exceeded the limit of 50 characters.

TimeoutException

Thrown if the operation exceeded the timeout value set by OperationTimeout.

OperationCanceledException

Thrown if the client entity has been closed or aborted.

MessagingEntityAlreadyExistsException

Thrown when an attempt is made to add another rule with same name as one that has already been added.

AddRule(String, Filter)

Adds a rule to the current subscription with the specified name and filter expression.

public void AddRule (string ruleName, Microsoft.ServiceBus.Messaging.Filter filter);

member this.AddRule : string * Microsoft.ServiceBus.Messaging.Filter -> unit

Public Sub AddRule (ruleName As String, filter As Filter)

Parameters

ruleName

String

The name of the rule to add.

filter

Filter

The filter expression against which messages will be matched.

Exceptions

ArgumentNullException

Thrown if filter is null.

ArgumentException

Thrown if ruleName is null, white space empty or not in the right format.

ArgumentOutOfRangeException

Thrown if ruleName length has exceeded the limit of 50 characters.

TimeoutException

Thrown if the operation exceeded the timeout value set via OperationTimeout.

OperationCanceledException

Thrown if the client entity has been closed or aborted.

MessagingEntityAlreadyExistsException

Thrown when an attempt is made to add another rule with same name as one that has already been added.