Class ExponentialBackOff

Implementation of IBackOff that increases the back-off period for each retry attempt using a randomization function that grows exponentially. In addition, it also adds a randomize number of milliseconds for each attempt.

Inheritance
object
ExponentialBackOff
Implements
Inherited Members
Namespace: Google.Apis.Util
Assembly: Google.Apis.Core.dll
Syntax
public class ExponentialBackOff : IBackOff

Constructors

ExponentialBackOff()

Constructs a new exponential back-off with default values.

Declaration
public ExponentialBackOff()

ExponentialBackOff(TimeSpan, int)

Constructs a new exponential back-off with the given delta and maximum retries.

Declaration
public ExponentialBackOff(TimeSpan deltaBackOff, int maximumNumOfRetries = 10)
Parameters
Type Name Description
TimeSpan deltaBackOff
int maximumNumOfRetries

Properties

DeltaBackOff

Gets the delta time span used to generate a random milliseconds to add to the next back-off. If the value is Zero then the generated back-off will be exactly 1, 2, 4, 8, 16, etc. seconds. A valid value is between zero and one second. The default value is 250ms, which means that the generated back-off will be [0.75-1.25]sec, [1.75-2.25]sec, [3.75-4.25]sec, and so on.

Declaration
public TimeSpan DeltaBackOff { get; }
Property Value
Type Description
TimeSpan

MaxNumOfRetries

Gets the maximum number of retries. Default value is 10.

Declaration
public int MaxNumOfRetries { get; }
Property Value
Type Description
int

Methods

GetNextBackOff(int)

Gets the a time span to wait before next retry. If the current retry reached the maximum number of retries, the returned value is MinValue.

Declaration
public TimeSpan GetNextBackOff(int currentRetry)
Parameters
Type Name Description
int currentRetry
Returns
Type Description
TimeSpan

Implements

Extension Methods