MsmqBindingElementBase.MaxRetryCycles Property


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

Namespace:   System.ServiceModel.Configuration
Assembly:  System.ServiceModel (in System.ServiceModel.dll)

[ConfigurationPropertyAttribute("maxRetryCycles", DefaultValue = 2)]
[IntegerValidatorAttribute(MinValue = 0)]
public int MaxRetryCycles { get; set; }

Property Value

Type: System.Int32

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

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.

.NET Framework
Available since 3.0
Return to top