MsmqBindingElementBase.MaxRetryCycles Property


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

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

public int MaxRetryCycles { get; set; }

Property Value

Type: System.Int32

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

Exception Condition

The value is less than zero.

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.

.NET Framework
Available since 3.0
Return to top