ExecutionStrategyExtensions.ExecuteInTransactionAsync 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
多載
ExecuteInTransactionAsync(IExecutionStrategy, Func<Task>, Func<Task<Boolean>>)
執行交易中指定的非同步操作。 允許在提交過程中發生錯誤時檢查交易是否已被回滾。
public static System.Threading.Tasks.Task ExecuteInTransactionAsync(this Microsoft.EntityFrameworkCore.Storage.IExecutionStrategy strategy, Func<System.Threading.Tasks.Task> operation, Func<System.Threading.Tasks.Task<bool>> verifySucceeded);
static member ExecuteInTransactionAsync : Microsoft.EntityFrameworkCore.Storage.IExecutionStrategy * Func<System.Threading.Tasks.Task> * Func<System.Threading.Tasks.Task<bool>> -> System.Threading.Tasks.Task
<Extension()>
Public Function ExecuteInTransactionAsync (strategy As IExecutionStrategy, operation As Func(Of Task), verifySucceeded As Func(Of Task(Of Boolean))) As Task
參數
- strategy
- IExecutionStrategy
執行時將採用的策略。
傳回
若原始任務成功完成(無論是第一次或重試短暫失敗後),該任務將執行至完成。 若任務以非暫態錯誤失敗或重試限制被觸及,回傳任務將出現故障,必須遵守例外。
例外狀況
設定的重試次數後,操作仍未成功。
備註
更多資訊與範例請參見 連線韌性與資料庫重試 。
適用於
ExecuteInTransactionAsync(IExecutionStrategy, Func<CancellationToken,Task>, Func<CancellationToken,Task<Boolean>>, CancellationToken)
執行交易中指定的非同步操作。 允許在提交過程中發生錯誤時檢查交易是否已被回滾。
public static System.Threading.Tasks.Task ExecuteInTransactionAsync(this Microsoft.EntityFrameworkCore.Storage.IExecutionStrategy strategy, Func<System.Threading.CancellationToken,System.Threading.Tasks.Task> operation, Func<System.Threading.CancellationToken,System.Threading.Tasks.Task<bool>> verifySucceeded, System.Threading.CancellationToken cancellationToken = default);
static member ExecuteInTransactionAsync : Microsoft.EntityFrameworkCore.Storage.IExecutionStrategy * Func<System.Threading.CancellationToken, System.Threading.Tasks.Task> * Func<System.Threading.CancellationToken, System.Threading.Tasks.Task<bool>> * System.Threading.CancellationToken -> System.Threading.Tasks.Task
<Extension()>
Public Function ExecuteInTransactionAsync (strategy As IExecutionStrategy, operation As Func(Of CancellationToken, Task), verifySucceeded As Func(Of CancellationToken, Task(Of Boolean)), Optional cancellationToken As CancellationToken = Nothing) As Task
參數
- strategy
- IExecutionStrategy
執行時將採用的策略。
- operation
- Func<CancellationToken,Task>
一個回傳已啟動任務的函式。
- verifySucceeded
- Func<CancellationToken,Task<Boolean>>
一個代理,測試即使交易提交時拋出例外,操作是否成功。
- cancellationToken
- CancellationToken
取消權杖用於取消重試操作,但不包括已在執行中或已成功完成的操作。
傳回
若原始任務成功完成(無論是第一次或重試短暫失敗後),該任務將執行至完成。 若任務以非暫態錯誤失敗或重試限制被觸及,回傳任務將出現故障,必須遵守例外。
例外狀況
設定的重試次數後,操作仍未成功。
備註
更多資訊與範例請參見 連線韌性與資料庫重試 。
適用於
ExecuteInTransactionAsync<TResult>(IExecutionStrategy, Func<CancellationToken, Task<TResult>>, Func<CancellationToken,Task<Boolean>>, CancellationToken)
執行交易中指定的非同步操作並回傳結果。 允許在提交過程中發生錯誤時檢查交易是否已被回滾。
public static System.Threading.Tasks.Task<TResult> ExecuteInTransactionAsync<TResult>(this Microsoft.EntityFrameworkCore.Storage.IExecutionStrategy strategy, Func<System.Threading.CancellationToken,System.Threading.Tasks.Task<TResult>> operation, Func<System.Threading.CancellationToken,System.Threading.Tasks.Task<bool>> verifySucceeded, System.Threading.CancellationToken cancellationToken = default);
static member ExecuteInTransactionAsync : Microsoft.EntityFrameworkCore.Storage.IExecutionStrategy * Func<System.Threading.CancellationToken, System.Threading.Tasks.Task<'Result>> * Func<System.Threading.CancellationToken, System.Threading.Tasks.Task<bool>> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Result>
<Extension()>
Public Function ExecuteInTransactionAsync(Of TResult) (strategy As IExecutionStrategy, operation As Func(Of CancellationToken, Task(Of TResult)), verifySucceeded As Func(Of CancellationToken, Task(Of Boolean)), Optional cancellationToken As CancellationToken = Nothing) As Task(Of TResult)
類型參數
- TResult
由 返回operation的結果類型Task<TResult>。
參數
- strategy
- IExecutionStrategy
執行時將採用的策略。
- operation
- Func<CancellationToken,Task<TResult>>
一個回傳類型 TResult為 的啟動任務的函式。
- verifySucceeded
- Func<CancellationToken,Task<Boolean>>
一個代理,測試即使交易提交時拋出例外,操作是否成功。
- cancellationToken
- CancellationToken
取消權杖用於取消重試操作,但不包括已在執行中或已成功完成的操作。
傳回
若原始任務成功完成(無論是第一次或重試短暫失敗後),該任務將執行至完成。 若任務以非暫態錯誤失敗或重試限制被觸及,回傳任務將出現故障,必須遵守例外。
例外狀況
設定的重試次數後,操作仍未成功。
備註
更多資訊與範例請參見 連線韌性與資料庫重試 。
適用於
ExecuteInTransactionAsync<TState,TResult>(IExecutionStrategy, Func<TState,CancellationToken,Task<TResult>>, Func<TState,CancellationToken, Task<Boolean>>, TState, DbContext, CancellationToken)
執行指定的非同步操作並回傳結果。
public static System.Threading.Tasks.Task<TResult> ExecuteInTransactionAsync<TState,TResult>(this Microsoft.EntityFrameworkCore.Storage.IExecutionStrategy strategy, Func<TState,System.Threading.CancellationToken,System.Threading.Tasks.Task<TResult>> operation, Func<TState,System.Threading.CancellationToken,System.Threading.Tasks.Task<bool>> verifySucceeded, TState state, Microsoft.EntityFrameworkCore.DbContext context, System.Threading.CancellationToken cancellationToken = default);
static member ExecuteInTransactionAsync : Microsoft.EntityFrameworkCore.Storage.IExecutionStrategy * Func<'State, System.Threading.CancellationToken, System.Threading.Tasks.Task<'Result>> * Func<'State, System.Threading.CancellationToken, System.Threading.Tasks.Task<bool>> * 'State * Microsoft.EntityFrameworkCore.DbContext * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Result>
<Extension()>
Public Function ExecuteInTransactionAsync(Of TState, TResult) (strategy As IExecutionStrategy, operation As Func(Of TState, CancellationToken, Task(Of TResult)), verifySucceeded As Func(Of TState, CancellationToken, Task(Of Boolean)), state As TState, context As DbContext, Optional cancellationToken As CancellationToken = Nothing) As Task(Of TResult)
類型參數
- TState
州的類型。
- TResult
由 返回operation的結果類型Task<TResult>。
參數
- strategy
- IExecutionStrategy
執行時將採用的策略。
- operation
- Func<TState,CancellationToken,Task<TResult>>
一個回傳類型 TResult為 的啟動任務的函式。
- verifySucceeded
- Func<TState,CancellationToken,Task<Boolean>>
一個代理,測試即使交易提交時拋出例外,操作是否成功。
- state
- TState
將要傳遞給行動的狀態。
- context
- DbContext
將用來啟動交易的上下文。
- cancellationToken
- CancellationToken
取消權杖用於取消重試操作,但不包括已在執行中或已成功完成的操作。
傳回
若原始任務成功完成(無論是第一次或重試短暫失敗後),該任務將執行至完成。 若任務以非暫態錯誤失敗或重試限制被觸及,回傳任務將出現故障,必須遵守例外。
例外狀況
若操作在設定的重試次數後仍未成功,則會拋棄。
適用於
ExecuteInTransactionAsync<TState,TResult>(IExecutionStrategy, TState, Func<TState,CancellationToken,Task<TResult>>, Func<TState, CancellationToken,Task<Boolean>>, CancellationToken)
執行交易中指定的非同步操作並回傳結果。 允許在提交過程中發生錯誤時檢查交易是否已被回滾。
public static System.Threading.Tasks.Task<TResult> ExecuteInTransactionAsync<TState,TResult>(this Microsoft.EntityFrameworkCore.Storage.IExecutionStrategy strategy, TState state, Func<TState,System.Threading.CancellationToken,System.Threading.Tasks.Task<TResult>> operation, Func<TState,System.Threading.CancellationToken,System.Threading.Tasks.Task<bool>> verifySucceeded, System.Threading.CancellationToken cancellationToken = default);
static member ExecuteInTransactionAsync : Microsoft.EntityFrameworkCore.Storage.IExecutionStrategy * 'State * Func<'State, System.Threading.CancellationToken, System.Threading.Tasks.Task<'Result>> * Func<'State, System.Threading.CancellationToken, System.Threading.Tasks.Task<bool>> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Result>
<Extension()>
Public Function ExecuteInTransactionAsync(Of TState, TResult) (strategy As IExecutionStrategy, state As TState, operation As Func(Of TState, CancellationToken, Task(Of TResult)), verifySucceeded As Func(Of TState, CancellationToken, Task(Of Boolean)), Optional cancellationToken As CancellationToken = Nothing) As Task(Of TResult)
類型參數
- TState
州的類型。
- TResult
由 返回operation的結果類型Task<TResult>。
參數
- strategy
- IExecutionStrategy
執行時將採用的策略。
- state
- TState
將要傳遞給行動的狀態。
- operation
- Func<TState,CancellationToken,Task<TResult>>
一個回傳類型 TResult為 的啟動任務的函式。
- verifySucceeded
- Func<TState,CancellationToken,Task<Boolean>>
一個代理,測試即使交易提交時拋出例外,操作是否成功。
- cancellationToken
- CancellationToken
取消權杖用於取消重試操作,但不包括已在執行中或已成功完成的操作。
傳回
若原始任務成功完成(無論是第一次或重試短暫失敗後),該任務將執行至完成。 若任務以非暫態錯誤失敗或重試限制被觸及,回傳任務將出現故障,必須遵守例外。
例外狀況
設定的重試次數後,操作仍未成功。
備註
更多資訊與範例請參見 連線韌性與資料庫重試 。
適用於
ExecuteInTransactionAsync<TState,TResult>(IExecutionStrategy, TState, Func<TState,CancellationToken,Task<TResult>>, Func<TState, CancellationToken,Task<Boolean>>, Func<DbContext,CancellationToken, Task<IDbContextTransaction>>, CancellationToken)
執行交易中指定的非同步操作並回傳結果。 允許在提交過程中發生錯誤時檢查交易是否已被回滾。
public static System.Threading.Tasks.Task<TResult> ExecuteInTransactionAsync<TState,TResult>(Microsoft.EntityFrameworkCore.Storage.IExecutionStrategy strategy, TState state, Func<TState,System.Threading.CancellationToken,System.Threading.Tasks.Task<TResult>> operation, Func<TState,System.Threading.CancellationToken,System.Threading.Tasks.Task<bool>> verifySucceeded, Func<Microsoft.EntityFrameworkCore.DbContext,System.Threading.CancellationToken,System.Threading.Tasks.Task<Microsoft.EntityFrameworkCore.Storage.IDbContextTransaction>> beginTransaction, System.Threading.CancellationToken cancellationToken = default);
static member ExecuteInTransactionAsync : Microsoft.EntityFrameworkCore.Storage.IExecutionStrategy * 'State * Func<'State, System.Threading.CancellationToken, System.Threading.Tasks.Task<'Result>> * Func<'State, System.Threading.CancellationToken, System.Threading.Tasks.Task<bool>> * Func<Microsoft.EntityFrameworkCore.DbContext, System.Threading.CancellationToken, System.Threading.Tasks.Task<Microsoft.EntityFrameworkCore.Storage.IDbContextTransaction>> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Result>
Public Function ExecuteInTransactionAsync(Of TState, TResult) (strategy As IExecutionStrategy, state As TState, operation As Func(Of TState, CancellationToken, Task(Of TResult)), verifySucceeded As Func(Of TState, CancellationToken, Task(Of Boolean)), beginTransaction As Func(Of DbContext, CancellationToken, Task(Of IDbContextTransaction)), Optional cancellationToken As CancellationToken = Nothing) As Task(Of TResult)
類型參數
- TState
州的類型。
- TResult
由 返回operation的結果類型Task<TResult>。
參數
- strategy
- IExecutionStrategy
執行時將採用的策略。
- state
- TState
將要傳遞給行動的狀態。
- operation
- Func<TState,CancellationToken,Task<TResult>>
一個回傳類型 TResult為 的啟動任務的函式。
- verifySucceeded
- Func<TState,CancellationToken,Task<Boolean>>
一個代理,測試即使交易提交時拋出例外,操作是否成功。
- beginTransaction
- Func<DbContext,CancellationToken,Task<IDbContextTransaction>>
代表者會以給定上下文開始交易。
- cancellationToken
- CancellationToken
取消權杖用於取消重試操作,但不包括已在執行中或已成功完成的操作。
傳回
若原始任務成功完成(無論是第一次或重試短暫失敗後),該任務將執行至完成。 若任務以非暫態錯誤失敗或重試限制被觸及,回傳任務將出現故障,必須遵守例外。
例外狀況
設定的重試次數後,操作仍未成功。
備註
更多資訊與範例請參見 連線韌性與資料庫重試 。
適用於
ExecuteInTransactionAsync<TState>(IExecutionStrategy, TState, Func<TState,CancellationToken,Task>, Func<TState,CancellationToken, Task<Boolean>>, CancellationToken)
執行交易中指定的非同步操作。 允許在提交過程中發生錯誤時檢查交易是否已被回滾。
public static System.Threading.Tasks.Task ExecuteInTransactionAsync<TState>(this Microsoft.EntityFrameworkCore.Storage.IExecutionStrategy strategy, TState state, Func<TState,System.Threading.CancellationToken,System.Threading.Tasks.Task> operation, Func<TState,System.Threading.CancellationToken,System.Threading.Tasks.Task<bool>> verifySucceeded, System.Threading.CancellationToken cancellationToken = default);
static member ExecuteInTransactionAsync : Microsoft.EntityFrameworkCore.Storage.IExecutionStrategy * 'State * Func<'State, System.Threading.CancellationToken, System.Threading.Tasks.Task> * Func<'State, System.Threading.CancellationToken, System.Threading.Tasks.Task<bool>> * System.Threading.CancellationToken -> System.Threading.Tasks.Task
<Extension()>
Public Function ExecuteInTransactionAsync(Of TState) (strategy As IExecutionStrategy, state As TState, operation As Func(Of TState, CancellationToken, Task), verifySucceeded As Func(Of TState, CancellationToken, Task(Of Boolean)), Optional cancellationToken As CancellationToken = Nothing) As Task
類型參數
- TState
州的類型。
參數
- strategy
- IExecutionStrategy
執行時將採用的策略。
- state
- TState
將要傳遞給行動的狀態。
- operation
- Func<TState,CancellationToken,Task>
一個回傳已啟動任務的函式。
- verifySucceeded
- Func<TState,CancellationToken,Task<Boolean>>
一個代理,測試即使交易提交時拋出例外,操作是否成功。
- cancellationToken
- CancellationToken
取消權杖用於取消重試操作,但不包括已在執行中或已成功完成的操作。
傳回
若原始任務成功完成(無論是第一次或重試短暫失敗後),該任務將執行至完成。 若任務以非暫態錯誤失敗或重試限制被觸及,回傳任務將出現故障,必須遵守例外。
例外狀況
設定的重試次數後,操作仍未成功。
備註
更多資訊與範例請參見 連線韌性與資料庫重試 。