MsmqBindingElementBase.MaxRetryCycles Property

Definition

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

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

Property Value

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

Attributes

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.

Applies to

Product Versions
.NET Framework 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1