QueuePolicy.MaxDequeueRetries Property

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

Gets or sets the value that determines how often the service will attempt to dequeue a message and deliver the message until it is considered poisonous.

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

Usage

    Dim instance As QueuePolicy
Dim value As Integer

value = instance.MaxDequeueRetries

instance.MaxDequeueRetries = value

Syntax

'Declaration
Public Property MaxDequeueRetries As Integer

public int MaxDequeueRetries { get; set; }

public:
property int MaxDequeueRetries {
    int get ();
    void set (int value);
}

/** @property */
public int get_MaxDequeueRetries ()

/** @property */
public void set_MaxDequeueRetries (int value)

public function get MaxDequeueRetries () : int

public function set MaxDequeueRetries (value : int)

Property Value

Returns Int32. Contains the maximum number of dequeue retries. The minimum value is 0, the default setting is 3, and the maximum value is 10.

Remarks

MaxDequeueRetries is not supported by the Service Bus Queue in the current release.

MaxDequeueRetries applies to Peek/Lock reads where the message is either undeliverable due to protocol issues or when the client is repeatedly unable or unwilling to delete the message after delivery. For destructive reads, MaxDequeueRetries becomes relevant if messages cannot be delivered to the receiver due to protocol issues. Once the permitted number of dequeue attempts has been exceeded for a message, the message is removed from the Queue. In this case, the messages may be delivered to the destination, as indicated by PoisonMessageDrop

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Development Platforms

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

Target Platforms

See Also

Reference

QueuePolicy Class
QueuePolicy Members
Microsoft.ServiceBus Namespace