DatabaseFacade.CanConnectAsync(CancellationToken) 方法

定義

命名空間:

Microsoft.EntityFrameworkCore.Infrastructure

組件:

Microsoft.EntityFrameworkCore.dll

套件:

Microsoft.EntityFrameworkCore v8.0.0

判斷資料庫是否可用且可連線。

public virtual System.Threading.Tasks.Task<bool> CanConnectAsync (System.Threading.CancellationToken cancellationToken = default);

abstract member CanConnectAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>
override this.CanConnectAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>

Public Overridable Function CanConnectAsync (Optional cancellationToken As CancellationToken = Nothing) As Task(Of Boolean)

參數

cancellationToken

CancellationToken

等候 CancellationToken 工作完成時要觀察的 。

傳回

Task<Boolean>

true 如果資料庫可用，則為 ; false 否則。

例外狀況

OperationCanceledException

如果取消 CancellationToken。

備註

嘗試連線時擲回的任何例外狀況都會被攔截，且不會傳播至應用程式。

設定的連接字串是用來以正常方式建立連線，因此會接受所有已設定的選項，例如逾時。

請注意，能夠連線到資料庫並不表示它對於架構建立等而言是最新的。

Entity Framework Core 不支援在相同的 DbCoNtext 實例上執行多個平行作業。 這包括平行執行非同步查詢，以及明確同時使用多個執行緒。 因此，請一律立即等候非同步呼叫，或針對平行執行的作業使用個別的 DbCoNtext 實例。 如需詳細資訊和範例，請參閱 避免 DbCoNtext 執行緒問題 。

如需詳細資訊和範例 ，請參閱 EF Core 中的資料庫連線 。