DbDataSource.OpenDbConnectionAsync(CancellationToken) 方法

定义

命名空间:

System.Data.Common

程序集:

System.Data.Common.dll

Source:

DbDataSource.cs

以异步方式返回与此 DbDataSource所表示的数据库的新打开连接。

protected virtual System.Threading.Tasks.ValueTask<System.Data.Common.DbConnection> OpenDbConnectionAsync (System.Threading.CancellationToken cancellationToken = default);

abstract member OpenDbConnectionAsync : System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<System.Data.Common.DbConnection>
override this.OpenDbConnectionAsync : System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<System.Data.Common.DbConnection>

Protected Overridable Function OpenDbConnectionAsync (Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of DbConnection)

参数

cancellationToken

CancellationToken

用于取消异步操作的令牌。

返回

ValueTask<DbConnection>

与由此 DbDataSource表示的数据库建立新的开放连接。

例外

OperationCanceledException

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

注解

此方法旨在通过实现 ADO.NET 提供程序来重写，并且不是面向用户的 API。

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