DatabaseFacade.EnsureDeletedAsync(CancellationToken) Metoda

Definicja

Przestrzeń nazw:

Microsoft.EntityFrameworkCore.Infrastructure

Zestaw:

Microsoft.EntityFrameworkCore.dll

Pakiet:

Microsoft.EntityFrameworkCore v8.0.0

Asynchronicznie gwarantuje, że baza danych dla kontekstu nie istnieje. Jeśli nie istnieje, nie zostanie podjęta żadna akcja. Jeśli istnieje, baza danych zostanie usunięta.

Ostrzeżenie: Cała baza danych jest usuwana i nie jest podejmowane żadne nakłady pracy, aby usunąć tylko obiekty bazy danych, które są używane przez model dla tego kontekstu.

[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)

Parametry

cancellationToken

CancellationToken

Element CancellationToken do obserwowania podczas oczekiwania na ukończenie zadania.

Zwraca

Task<Boolean>

Zadanie reprezentujące operację zapisywania asynchronicznego. Wynik zadania zawiera true informacje o tym, czy baza danych została usunięta, false jeśli nie istnieje.

Atrybuty

RequiresDynamicCodeAttribute

Wyjątki

OperationCanceledException

Jeśli element CancellationToken zostanie anulowany.

Uwagi

Często używa EnsureCreatedAsync(CancellationToken) się ich natychmiast podczas EnsureDeletedAsync(CancellationToken) testowania lub tworzenia prototypów przy użyciu programu Entity Framework. Gwarantuje to, że baza danych jest w stanie czystym przed każdym wykonaniem testu/prototypu. Należy jednak pamiętać, że dane w bazie danych nie są zachowywane.

Program Entity Framework Core nie obsługuje wielu równoległych operacji uruchamianych w tym samym wystąpieniu dbContext. Obejmuje to zarówno równoległe wykonywanie zapytań asynchronicznych, jak i wszelkie jawne współbieżne użycie z wielu wątków. W związku z tym zawsze czekaj na wywołania asynchroniczne natychmiast lub używaj oddzielnych wystąpień dbContext dla operacji wykonywanych równolegle. Aby uzyskać więcej informacji i przykładów, zobacz Unikanie problemów z wątkami dbContext .

Aby uzyskać więcej informacji i przykładów, zobacz Zarządzanie schematami baz danych za pomocą interfejsów API tworzenia baz danych i platformy EF Core.