Edit

Share via


ReliableSessionElement.MaxRetryCount Property

Definition

Gets or sets the maximum number of times a reliable channel attempts to retransmit a message it has not received an acknowledgment for, by calling Send on its underlying channel.

public:
 property int MaxRetryCount { int get(); void set(int value); };
[System.Configuration.ConfigurationProperty("maxRetryCount", DefaultValue=8)]
[System.Configuration.IntegerValidator(MinValue=1)]
public int MaxRetryCount { get; set; }
[<System.Configuration.ConfigurationProperty("maxRetryCount", DefaultValue=8)>]
[<System.Configuration.IntegerValidator(MinValue=1)>]
member this.MaxRetryCount : int with get, set
Public Property MaxRetryCount As Integer

Property Value

The maximum number of times a reliable channel attempts to retransmit a message it has not received an acknowledgment for, by calling Send on its underlying channel. The minimum value is 1; the maximum 20; and the default value is 8.

Attributes

Remarks

This value should be an integer greater than zero. If an acknowledgment is not received after the last retransmission, the channel faults.

A message is considered to be transferred if its delivery at the recipient is acknowledged by the recipient.

If an acknowledgment is not received within a certain amount of time for a message that has been transmitted, the infrastructure automatically retransmits the message. The infrastructure tries to resend the message for, at most, the number of times specified by this property. If an acknowledgment is not received after the last retransmission, the channel faults.

The infrastructure uses an exponential back-off algorithm to determine when to retransmit, based on a computed average round-trip time. The time initially starts at 1 second before retransmission and doubling the delay with every attempt, which results in approximately 8.5 minutes passing between the first transmission attempt and the last retransmission attempt. The time for the first retransmission attempt is adjusted according to the calculated round-trip time and the resulting stretch of time that those attempts take varies accordingly. This allows the retransmission time to dynamically adapt to varying network conditions.

Applies to