DatabaseFacade.EnsureCreatedAsync(CancellationToken) 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
確保內容的資料庫存在。
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.")]
public virtual System.Threading.Tasks.Task<bool> EnsureCreatedAsync (System.Threading.CancellationToken cancellationToken = default);abstract member EnsureCreatedAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>
override this.EnsureCreatedAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>[<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等候工作完成時要觀察的 。
傳回
代表非同步儲存作業的工作。 如果資料庫已存在， false 則工作結果會 true 包含 。
- 屬性
例外狀況
備註
- 如果資料庫存在且具有任何資料表，則不會採取任何動作。 不執行任何動作，以確保資料庫架構與 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 管理資料庫 架構。
