Skip to main content

Enable an application to handle transient failures when it tries to connect to a service or network resource, by transparently retrying a failed operation. This can improve the stability of the application. This example in C# illustrates an implementation of the Retry pattern. The OperationWithBasicRetryAsync method, shown below, invokes an external service asynchronously through the TransientOperationAsync method. The details of the TransientOperationAsync method will be specific to the service and are omitted from the sample code.

private int retryCount = 3;
private readonly TimeSpan delay = TimeSpan.FromSeconds(5);

public async Task OperationWithBasicRetryAsync()
    int currentRetry = 0;

    for (;;)
            // Call external service.
            await TransientOperationAsync();

            // Return or break.
        catch (Exception ex)
            Trace.TraceError("Operation Exception");


            // Check if the exception thrown was a transient exception
            // based on the logic in the error detection strategy.
            // Determine whether to retry the operation, as well as how
            // long to wait, based on the retry strategy.
            if (currentRetry > this.retryCount || !IsTransient(ex))
                // If this isn't a transient error or we shouldn't retry,
                // rethrow the exception.

        // Wait to retry the operation.
        // Consider calculating an exponential delay here and
        // using a strategy best suited for the operation and fault.
        await Task.Delay(delay);

// Async method that wraps a call to a remote service (details not shown).
private async Task TransientOperationAsync()

// The IsTransient method, shown below, checks for a specific set of exceptions
// that are relevant to the environment the code is run in. The definition of a
// transient exception will vary according to the resources being accessed and
// the environment the operation is being performed in.

private bool IsTransient(Exception ex)
    // Determine if the exception is transient.
    // In some cases this is as simple as checking the exception type, in other
    // cases it might be necessary to inspect other properties of the exception.
    if (ex is OperationTransientException)
        return true;

    var webException = ex as WebException;
    if (webException != null)
        // If the web exception contains one of the following status values
        // it might be transient.
        return new[] { WebExceptionStatus.ConnectionClosed,
                       WebExceptionStatus.RequestCanceled }.Contains(webException.Status);

    // Additional exception checking logic goes here.
    return false;