ExecutionStrategy Class

Definition

Namespace:

Microsoft.EntityFrameworkCore.Storage

Assembly:

Microsoft.EntityFrameworkCore.dll

Package:

Microsoft.EntityFrameworkCore v8.0.0

The base class for IExecutionStrategy implementations.

public abstract class ExecutionStrategy : Microsoft.EntityFrameworkCore.Storage.IExecutionStrategy

type ExecutionStrategy = class
    interface IExecutionStrategy

Public MustInherit Class ExecutionStrategy
Implements IExecutionStrategy

Inheritance

Object

ExecutionStrategy

Derived

Microsoft.EntityFrameworkCore.SqlServerRetryingExecutionStrategy

Implements

IExecutionStrategy

Remarks

The service lifetime is Scoped. This means that each DbContext instance will use its own instance of this service. The implementation may depend on other services registered with any lifetime. The implementation does not need to be thread-safe.

See Connection resiliency and database retries for more information and examples.

Constructors

ExecutionStrategy(DbContext, Int32, TimeSpan)	Creates a new instance of ExecutionStrategy.
ExecutionStrategy(ExecutionStrategyDependencies, Int32, TimeSpan)	Creates a new instance of ExecutionStrategy.

Fields

DefaultMaxDelay	The default maximum time delay between retries, must be nonnegative.
DefaultMaxRetryCount	The default number of retry attempts.

Properties

Current	Gets or sets the currently executing strategy. All nested calls will be handled by the outermost strategy.
Dependencies	Dependencies for this service.
ExceptionsEncountered	The list of exceptions that caused the operation to be retried so far.
MaxRetryCount	The maximum number of retry attempts.
MaxRetryDelay	The maximum delay between retries.
Random	A pseudo-random number generator that can be used to vary the delay between retries.
RetriesOnFailure	Indicates whether this IExecutionStrategy might retry the execution after a failure.

Methods

CallOnWrappedException<TResult>(Exception, Func<Exception,TResult>)	Recursively gets InnerException from exception as long as it is an exception created by Entity Framework and calls exceptionHandler on the innermost one.
Execute<TState,TResult>(TState, Func<DbContext,TState,TResult>, Func<DbContext,TState,ExecutionResult<TResult>>)	Executes the specified operation and returns the result.
ExecuteAsync<TState,TResult>(TState, Func<DbContext,TState,CancellationToken, Task<TResult>>, Func<DbContext,TState,CancellationToken,Task<ExecutionResult<TResult>>>, CancellationToken)	Executes the specified asynchronous operation and returns the result.
GetNextDelay(Exception)	Determines whether the operation should be retried and the delay before the next attempt.
OnFirstExecution()	Method called before the first operation execution
OnRetry()	Method called before retrying the operation execution
ShouldRetryOn(Exception)	Determines whether the specified exception represents a transient failure that can be compensated by a retry.
ShouldVerifySuccessOn(Exception)	Determines whether the specified exception could be thrown after a successful execution.

Extension Methods

Execute(IExecutionStrategy, Action)	Executes the specified operation.
Execute<TState>(IExecutionStrategy, TState, Action<TState>)	Executes the specified operation.
Execute<TResult>(IExecutionStrategy, Func<TResult>)	Executes the specified operation and returns the result.
Execute<TState,TResult>(IExecutionStrategy, TState, Func<TState,TResult>)	Executes the specified operation and returns the result.
Execute<TState,TResult>(IExecutionStrategy, TState, Func<TState,TResult>, Func<TState,ExecutionResult<TResult>>)	Executes the specified operation and returns the result.
ExecuteAsync(IExecutionStrategy, Func<CancellationToken,Task>, CancellationToken)	Executes the specified asynchronous operation.
ExecuteAsync(IExecutionStrategy, Func<Task>)	Executes the specified asynchronous operation.
ExecuteAsync<TState>(IExecutionStrategy, TState, Func<TState,CancellationToken,Task>, CancellationToken)	Executes the specified asynchronous operation.
ExecuteAsync<TState>(IExecutionStrategy, TState, Func<TState,Task>)	Executes the specified asynchronous operation.
ExecuteAsync<TResult>(IExecutionStrategy, Func<CancellationToken,Task<TResult>>, CancellationToken)	Executes the specified asynchronous operation and returns the result.
ExecuteAsync<TResult>(IExecutionStrategy, Func<Task<TResult>>)	Executes the specified asynchronous operation and returns the result.
ExecuteAsync<TState,TResult>(IExecutionStrategy, TState, Func<TState, CancellationToken,Task<TResult>>, Func<TState,CancellationToken, Task<ExecutionResult<TResult>>>, CancellationToken)	Executes the specified asynchronous operation and returns the result.
ExecuteAsync<TState,TResult>(IExecutionStrategy, TState, Func<TState,CancellationToken,Task<TResult>>, CancellationToken)	Executes the specified asynchronous operation and returns the result.
ExecuteAsync<TState,TResult>(IExecutionStrategy, TState, Func<TState,Task<TResult>>)	Executes the specified asynchronous operation and returns the result.
ExecuteInTransaction(IExecutionStrategy, Action, Func<Boolean>)	Executes the specified operation in a transaction. Allows to check whether the transaction has been rolled back if an error occurs during commit.
ExecuteInTransaction<TState>(IExecutionStrategy, TState, Action<TState>, Func<TState,Boolean>)	Executes the specified operation in a transaction. Allows to check whether the transaction has been rolled back if an error occurs during commit.
ExecuteInTransaction<TResult>(IExecutionStrategy, Func<TResult>, Func<Boolean>)	Executes the specified operation in a transaction and returns the result. Allows to check whether the transaction has been rolled back if an error occurs during commit.
ExecuteInTransaction<TState,TResult>(IExecutionStrategy, TState, Func<TState,TResult>, Func<TState,Boolean>)	Executes the specified operation in a transaction and returns the result. Allows to check whether the transaction has been rolled back if an error occurs during commit.
ExecuteInTransactionAsync(IExecutionStrategy, Func<CancellationToken,Task>, Func<CancellationToken,Task<Boolean>>, CancellationToken)	Executes the specified asynchronous operation in a transaction. Allows to check whether the transaction has been rolled back if an error occurs during commit.
ExecuteInTransactionAsync(IExecutionStrategy, Func<Task>, Func<Task<Boolean>>)	Executes the specified asynchronous operation in a transaction. Allows to check whether the transaction has been rolled back if an error occurs during commit.
ExecuteInTransactionAsync<TState>(IExecutionStrategy, TState, Func<TState,CancellationToken,Task>, Func<TState,CancellationToken, Task<Boolean>>, CancellationToken)	Executes the specified asynchronous operation in a transaction. Allows to check whether the transaction has been rolled back if an error occurs during commit.
ExecuteInTransactionAsync<TResult>(IExecutionStrategy, Func<CancellationToken, Task<TResult>>, Func<CancellationToken,Task<Boolean>>, CancellationToken)	Executes the specified asynchronous operation in a transaction and returns the result. Allows to check whether the transaction has been rolled back if an error occurs during commit.
ExecuteInTransactionAsync<TState,TResult>(IExecutionStrategy, TState, Func<TState,CancellationToken,Task<TResult>>, Func<TState, CancellationToken,Task<Boolean>>, CancellationToken)	Executes the specified asynchronous operation in a transaction and returns the result. Allows to check whether the transaction has been rolled back if an error occurs during commit.
ExecuteInTransaction(IExecutionStrategy, Action, Func<Boolean>, IsolationLevel)	Executes the specified operation in a transaction. Allows to check whether the transaction has been rolled back if an error occurs during commit.
ExecuteInTransaction<TState>(IExecutionStrategy, TState, Action<TState>, Func<TState,Boolean>, IsolationLevel)	Executes the specified operation in a transaction. Allows to check whether the transaction has been rolled back if an error occurs during commit.
ExecuteInTransaction<TResult>(IExecutionStrategy, Func<TResult>, Func<Boolean>, IsolationLevel)	Executes the specified operation in a transaction and returns the result. Allows to check whether the transaction has been rolled back if an error occurs during commit.
ExecuteInTransaction<TState,TResult>(IExecutionStrategy, TState, Func<TState,TResult>, Func<TState,Boolean>, IsolationLevel)	Executes the specified operation in a transaction and returns the result. Allows to check whether the transaction has been rolled back if an error occurs during commit.
ExecuteInTransactionAsync(IExecutionStrategy, Func<CancellationToken,Task>, Func<CancellationToken,Task<Boolean>>, IsolationLevel, CancellationToken)	Executes the specified asynchronous operation in a transaction. Allows to check whether the transaction has been rolled back if an error occurs during commit.
ExecuteInTransactionAsync(IExecutionStrategy, Func<Task>, Func<Task<Boolean>>, IsolationLevel)	Executes the specified asynchronous operation in a transaction. Allows to check whether the transaction has been rolled back if an error occurs during commit.
ExecuteInTransactionAsync<TState>(IExecutionStrategy, TState, Func<TState,CancellationToken,Task>, Func<TState,CancellationToken, Task<Boolean>>, IsolationLevel, CancellationToken)	Executes the specified asynchronous operation in a transaction. Allows to check whether the transaction has been rolled back if an error occurs during commit.
ExecuteInTransactionAsync<TResult>(IExecutionStrategy, Func<CancellationToken, Task<TResult>>, Func<CancellationToken,Task<Boolean>>, IsolationLevel, CancellationToken)	Executes the specified asynchronous operation in a transaction and returns the result. Allows to check whether the transaction has been rolled back if an error occurs during commit.
ExecuteInTransactionAsync<TState,TResult>(IExecutionStrategy, TState, Func<TState,CancellationToken,Task<TResult>>, Func<TState, CancellationToken,Task<Boolean>>, IsolationLevel, CancellationToken)	Executes the specified asynchronous operation and returns the result. Allows to check whether the transaction has been rolled back if an error occurs during commit.