DbConnection.OpenAsync 方法

定義

命名空間:

System.Data.Common

組件:

System.Data.Common.dll

此方法會實作非同步版本的 Open()。

多載

OpenAsync()	非同步版本的 Open()，這個版本會透過 ConnectionString 所指定的設定開啟資料庫連接。 這個方法會叫用虛擬方法 OpenAsync(CancellationToken) 與 CancellationToken.None。
OpenAsync(CancellationToken)	這是 Open() 的非同步版本。 提供者應該覆寫為適當的實作。 可以選擇性地接受取消語彙基元。 預設實作會叫用同步Open()呼叫並傳回完成的工作。 如果傳遞一個已經被取消的 cancellationToken，預設實作會傳回已取消的工作。 Open 擲回的例外狀況會透過傳回的工作例外狀況屬性來傳送。 在傳回的工作完成之前，不叫用 DbConnection 物件的其他方法及屬性。

備註

如需 .NET Framework Data Provider for SQL Server 中異步程式設計的詳細資訊，請參閱異步程序設計。

OpenAsync()

來源:

DbConnection.cs

非同步版本的 Open()，這個版本會透過 ConnectionString 所指定的設定開啟資料庫連接。 這個方法會叫用虛擬方法 OpenAsync(CancellationToken) 與 CancellationToken.None。

public:
 System::Threading::Tasks::Task ^ OpenAsync();

public System.Threading.Tasks.Task OpenAsync ();

member this.OpenAsync : unit -> System.Threading.Tasks.Task

Public Function OpenAsync () As Task

傳回

Task

表示非同步作業的工作。

備註

呼叫 OpenAsync之後， State 必須傳回 ，直到傳回 Connecting 的 Task 完成為止。 然後，如果連線成功， State 則必須傳回 Open。 如果連線失敗， State 則必須傳回 Closed。

的呼叫 Close 會嘗試取消或關閉對應的 OpenAsync 呼叫。

如需 .NET Framework Data Provider for SQL Server 中異步程式設計的詳細資訊，請參閱異步程序設計。

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

另請參閱

• ADO.NET 概觀 \(部分機器翻譯\)

OpenAsync(CancellationToken)

來源:

DbConnection.cs

這是 Open() 的非同步版本。 提供者應該覆寫為適當的實作。 可以選擇性地接受取消語彙基元。

預設實作會叫用同步Open()呼叫並傳回完成的工作。 如果傳遞一個已經被取消的 cancellationToken，預設實作會傳回已取消的工作。 Open 擲回的例外狀況會透過傳回的工作例外狀況屬性來傳送。

在傳回的工作完成之前，不叫用 DbConnection 物件的其他方法及屬性。

public:
 virtual System::Threading::Tasks::Task ^ OpenAsync(System::Threading::CancellationToken cancellationToken);

public virtual System.Threading.Tasks.Task OpenAsync (System.Threading.CancellationToken cancellationToken);

abstract member OpenAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.OpenAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Overridable Function OpenAsync (cancellationToken As CancellationToken) As Task

參數

cancellationToken

CancellationToken

取消指令。

傳回

Task

表示非同步作業的工作。

例外狀況

OperationCanceledException

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

備註

呼叫 OpenAsync之後， State 必須傳回 ，直到傳回 Connecting 的 Task 完成為止。 然後，如果連線成功， State 則必須傳回 Open。 如果連線失敗， State 則必須傳回 Closed。

的呼叫 Close 會嘗試取消或關閉對應的 OpenAsync 呼叫。

如需 .NET Framework Data Provider for SQL Server 中異步程式設計的詳細資訊，請參閱異步程序設計。

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

另請參閱

• ADO.NET 概觀 \(部分機器翻譯\)