DbConnection.BeginTransactionAsync 方法

定义

命名空间:

System.Data.Common

程序集:

System.Data.Common.dll

重载

BeginTransactionAsync(CancellationToken)	异步开始数据库事务。
BeginTransactionAsync(IsolationLevel, CancellationToken)	异步开始数据库事务。

BeginTransactionAsync(CancellationToken)

Source:

DbConnection.cs

异步开始数据库事务。

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。

返回

ValueTask<DbTransaction>

一个任务，其 Result 属性为表示新事物的对象。

例外

OperationCanceledException

取消令牌已取消。 此异常存储在返回的任务中。

注解

如果未指定隔离级别，将使用特定连接类型的默认隔离级别。

此异步方法的默认实现委托给其同步方法，并返回一个已完成 Task的 ，可能会阻止调用线程。

支持 异步编程 的数据提供程序应使用异步 I/O 操作替代默认实现。

此方法存储在任务中，它返回该方法的同步对应项可能引发的所有非使用异常。 如果异常存储在返回的任务中，则在等待任务时将引发该异常。 使用异常（如 ArgumentException）仍会同步引发。 有关存储的异常，请参阅 引发的 BeginTransaction()异常。

BeginTransactionAsync(IsolationLevel, CancellationToken)

Source:

DbConnection.cs

异步开始数据库事务。

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。

返回

ValueTask<DbTransaction>

一个任务，其 Result 属性为表示新事物的对象。

例外

OperationCanceledException

取消令牌已取消。 此异常存储在返回的任务中。

注解

此异步方法的默认实现委托给其同步方法，并返回一个已完成 Task的 ，可能会阻止调用线程。

支持 异步编程 的数据提供程序应使用异步 I/O 操作替代默认实现。

此方法存储在任务中，它返回该方法的同步对应项可能引发的所有非使用异常。 如果异常存储在返回的任务中，则在等待任务时将引发该异常。 使用异常（如 ArgumentException）仍会同步引发。 有关存储的异常，请参阅 引发的 BeginTransaction(IsolationLevel)异常。