DatabaseFacade.EnsureCreatedAsync(CancellationToken) 方法

定義

命名空間:

Microsoft.EntityFrameworkCore.Infrastructure

組件:

Microsoft.EntityFrameworkCore.dll

套件:

Microsoft.EntityFrameworkCore v8.0.0

確保內容的資料庫存在。

[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("Migrations operations require building the design-time model which is not supported with NativeAOT Use a migration bundle or an alternate way of executing migration operations.")]
public virtual System.Threading.Tasks.Task<bool> EnsureCreatedAsync (System.Threading.CancellationToken cancellationToken = default);

[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("Migrations operations require building the design-time model which is not supported with NativeAOT Use a migration bundle or an alternate way of executing migration operations.")>]
abstract member EnsureCreatedAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>
override this.EnsureCreatedAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>

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

參數

cancellationToken

CancellationToken

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

傳回

Task<Boolean>

代表非同步儲存作業的工作。 如果資料庫已存在， false 則工作結果會 true 包含 。

屬性

RequiresDynamicCodeAttribute

例外狀況

OperationCanceledException

如果取消 CancellationToken。

備註

• 如果資料庫存在且具有任何資料表，則不會採取任何動作。 不執行任何動作，以確保資料庫架構與 Entity Framework 模型相容。
• 如果資料庫存在但沒有任何資料表，則會使用 Entity Framework 模型來建立資料庫架構。
• 如果資料庫不存在，則會建立資料庫，並使用 Entity Framework 模型來建立資料庫架構。

使用 Entity Framework 進行測試或原型設計時， EnsureDeletedAsync(CancellationToken) 通常會立即使用 EnsureCreatedAsync(CancellationToken) 。 這可確保資料庫在每次執行測試/原型之前都處於乾淨狀態。 不過請注意，資料庫中的資料不會保留。

請注意，此 API 不會使用移轉來建立資料庫。 此外，稍後無法使用移轉來更新所建立的資料庫。 如果您的目標是關係資料庫並使用移轉，則可以使用 Microsoft.EntityFrameworkCore.RelationalDatabaseFacadeExtensions.MigrateAsync 來確保資料庫是使用移轉建立的，而且已套用所有移轉。

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

如需詳細資訊和範例 ，請參閱使用 EF Core 和 資料庫建立 API 管理資料庫 架構。