Export (0) Print
Expand All

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 */
public int get_MaxRetryCycles ()

/** @property */
public void set_MaxRetryCycles (int value)

public function get MaxRetryCycles () : int

public function set MaxRetryCycles (value : int)

Not applicable.

Property Value

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

Exception typeCondition


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 will be made a maximum of (1 + MaxRetryCycles) * (ReceiveRetryCount + 1) times. For example, if ReceiveRetryCount = 0 and MaxRetryCycles is 1, there will be a maximum of two attempts to deliver the message. This property is used only on Windows Vista or later operating systems.

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0

Community Additions

© 2014 Microsoft