DbDataSource.OpenDbConnectionAsync(CancellationToken) 方法

定義

以異步方式傳回與這個 DbDataSource所表示之資料庫的新開啟連接。

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

參數

cancellationToken
CancellationToken

取消非同步作業的語彙基元。

傳回

這個 所 DbDataSource表示之資料庫的新開啟連接。

例外狀況

取消標記已取消。 此例外狀況會儲存在傳回的工作中。

備註

此方法旨在藉由實作 ADO.NET 提供者來覆寫,而不是使用者面向的 API。

這個方法會儲存在工作中,它會傳回方法同步對應專案可以擲回的所有非使用例外狀況。 如果例外狀況儲存在傳回的工作中,則會在等候工作時擲回該例外狀況。 使用例外狀況,例如 ArgumentException仍會同步擲回。 如需預存例外狀況,請參閱 擲回的 OpenDbConnection()例外狀況。

適用於

產品 版本
.NET 7, 8, 9, 10