MsmqBindingElementBase.MaxRetryCycles Property

Reference

Definition

Namespace:: System.ServiceModel.Channels

Assembly:: System.ServiceModel.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

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

Int32

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

Exceptions

ArgumentOutOfRangeException

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

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

Share via