BrokeredMessage.Defer Method

Definition

Namespace:

Microsoft.ServiceBus.Messaging

Assembly:

Microsoft.ServiceBus.dll

Package:

WindowsAzure.ServiceBus v6.2.2

Overloads

Defer()	Indicates that the receiver wants to defer the processing for this message.
Defer(IDictionary<String,Object>)	Indicates that the receiver wants to defer the processing for this message.

Defer()

Indicates that the receiver wants to defer the processing for this message.

public void Defer ();

member this.Defer : unit -> unit

Public Sub Defer ()

Exceptions

ObjectDisposedException

Thrown when the message is in the disposed state or the receiver with which the message was received is in the disposed state.

InvalidOperationException

Thrown when invoked on a message that has not been received from the message server or invoked on a message that has not been received in peek-lock mode.

MessagingCommunicationException

Thrown when the queue or subscription that receives the message is no longer present in the message server.

TimeoutException

Thrown when the operation times out. The timeout period is initialized through the MessagingFactorySettings. You may need to increase the value of OperationTimeout to avoid this exception if the timeout value is relatively low.

MessageLockLostException

Thrown if the lock on the message has expired. LockDuration is an entity-wide setting and can be initialized through LockDuration and LockDuration for queues and subscriptions respectively.

SessionLockLostException

Thrown if the lock on the session has expired. The session lock duration is the same as the message LockDuration and is an entity-wide setting. It can be initialized through LockDuration and LockDuration for queues and subscriptions respectively.

ServerBusyException

When service bus service is busy and is unable process the request.

MessagingEntityNotFoundException

When messaging entity the message was received from has been deleted.

UnauthorizedAccessException

When the security token provided by the TokenProvider does not contain the claims to perform this operation.

QuotaExceededException

When the number of concurrent connections to an entity exceed the maximum allowed value.

Remarks

Before deferring the message, user MUST set aside the message receipt for later retrieval.

Defer(IDictionary<String,Object>)

Indicates that the receiver wants to defer the processing for this message.

public void Defer (System.Collections.Generic.IDictionary<string,object> propertiesToModify);

member this.Defer : System.Collections.Generic.IDictionary<string, obj> -> unit

Public Sub Defer (propertiesToModify As IDictionary(Of String, Object))

Parameters

propertiesToModify

IDictionary<String,Object>

The key-value pair collection of properties to modify.

Remarks

Before deferring the message, user MUST set aside the message receipt for later retrieval.