Windows apps
Collapse the table of content
Expand the table of content
Information
Switch
Switch
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

MsmqBindingElementBase::MaxRetryCycles Property

.NET Framework (current version)
 

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)

C#
C++
F#
VB
Copy 
public:
property int MaxRetryCycles {
	int get();
	void set(int value);
}

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
ArgumentOutOfRangeException

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
Show:
© 2017 Microsoft