DatabaseFacade.EnsureDeletedAsync(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> EnsureDeletedAsync (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 EnsureDeletedAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>
override this.EnsureDeletedAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>

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

參數

cancellationToken

CancellationToken

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

傳回

Task<Boolean>

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

屬性

RequiresDynamicCodeAttribute

例外狀況

OperationCanceledException

如果取消 CancellationToken。

備註

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

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

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