MsmqBindingElementBase.MaxRetryCycles Property

Definition

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); };
public int MaxRetryCycles { get; set; }
member this.MaxRetryCycles : int with get, set
Public Property MaxRetryCycles As Integer

Property Value

A value that specifies the number of retry cycles to attempt prior to transferring a message to the poison-message queue.

Exceptions

The value is less than zero.

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 used only on operating systems starting with Windows Vista.

Applies to