MsmqBindingElementBase.MaxRetryCycles Property

Definition

Namespace:

System.ServiceModel.Configuration

Assembly:

System.ServiceModel.dll

Gets or sets the maximum number of retry cycles to attempt delivery of messages to the receiving application.

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

[System.Configuration.ConfigurationProperty("maxRetryCycles", DefaultValue=2)]
[System.Configuration.IntegerValidator(MinValue=0)]
public int MaxRetryCycles { get; set; }

[<System.Configuration.ConfigurationProperty("maxRetryCycles", DefaultValue=2)>]
[<System.Configuration.IntegerValidator(MinValue=0)>]
member this.MaxRetryCycles : int with get, set

Public Property MaxRetryCycles As Integer

Property Value

Int32

The maximum number of retry cycles to attempt prior to transferring a message to the poison-message queue.

Attributes

ConfigurationPropertyAttribute IntegerValidatorAttribute

Remarks

A retry cycle is when a message is transferred from the retry queue to the application queue to attempt delivery to the application. Messages are placed in the retry queue after failing a number of immediate retries as specified by ReceiveRetryCount. MaxRetryCycles specifies the number of retry cycles and does not include the initial attempt to send the message. An attempt to deliver a message is made a maximum of (1 + MaxRetryCycles) * (ReceiveRetryCount + 1) times. For example, if ReceiveRetryCount = 0 and MaxRetryCycles is 1, there is a maximum of two attempts to deliver the message. This property is available starting with the Windows Vista operating system.