DbConnection.BeginTransactionAsync 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
多載
| 名稱 | Description |
|---|---|
| BeginTransactionAsync(CancellationToken) |
非同步啟動資料庫交易。 |
| BeginTransactionAsync(IsolationLevel, CancellationToken) |
非同步啟動資料庫交易。 |
BeginTransactionAsync(CancellationToken)
非同步啟動資料庫交易。
public System.Threading.Tasks.ValueTask<System.Data.Common.DbTransaction> BeginTransactionAsync(System.Threading.CancellationToken cancellationToken = default);
member this.BeginTransactionAsync : System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<System.Data.Common.DbTransaction>
Public Function BeginTransactionAsync (Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of DbTransaction)
參數
- cancellationToken
- CancellationToken
一個可選的標記來取消非同步操作。 預設值為 None。
傳回
一個屬性 Result 為代表新交易的物件的任務。
例外狀況
取消令牌也被取消了。 此例外會儲存在回傳的任務中。
備註
若未指定隔離等級,則使用該連線類型預設的隔離等級。
此非同步方法的預設實作會委派給同步對應程序,並回傳完成 Task的 ,可能會阻塞呼叫執行緒。
支援 非同步程式設計 的資料提供者應透過非同步 I/O 操作覆蓋預設實作。
此方法在任務中儲存所有非使用例外,該方法的同步對應程式可拋出這些例外。 如果回傳的任務中儲存了例外,該例外會在等待任務時拋出。 使用例外錯誤,例如 ArgumentException,仍會同步拋出。 關於儲存的例外,請參見由 BeginTransaction()拋出的例外。
適用於
BeginTransactionAsync(IsolationLevel, CancellationToken)
非同步啟動資料庫交易。
public System.Threading.Tasks.ValueTask<System.Data.Common.DbTransaction> BeginTransactionAsync(System.Data.IsolationLevel isolationLevel, System.Threading.CancellationToken cancellationToken = default);
member this.BeginTransactionAsync : System.Data.IsolationLevel * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<System.Data.Common.DbTransaction>
Public Function BeginTransactionAsync (isolationLevel As IsolationLevel, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of DbTransaction)
參數
- isolationLevel
- IsolationLevel
其中一個列舉值,用來指定交易要使用的隔離層級。
- cancellationToken
- CancellationToken
一個可選的標記來取消非同步操作。 預設值為 None。
傳回
一個屬性 Result 為代表新交易的物件的任務。
例外狀況
取消令牌也被取消了。 此例外會儲存在回傳的任務中。
備註
此非同步方法的預設實作會委派給同步對應程序,並回傳完成 Task的 ,可能會阻塞呼叫執行緒。
支援 非同步程式設計 的資料提供者應透過非同步 I/O 操作覆蓋預設實作。
此方法在任務中儲存所有非使用例外,該方法的同步對應程式可拋出這些例外。 如果回傳的任務中儲存了例外,該例外會在等待任務時拋出。 使用例外錯誤,例如 ArgumentException,仍會同步拋出。 關於儲存的例外,請參見由 BeginTransaction(IsolationLevel)拋出的例外。