DatabaseFacade.EnsureDeletedAsync(CancellationToken) Método

Definición

Espacio de nombres:

Microsoft.EntityFrameworkCore.Infrastructure

Ensamblado:

Microsoft.EntityFrameworkCore.dll

Paquete:

Microsoft.EntityFrameworkCore v8.0.0

Garantiza de forma asincrónica que la base de datos del contexto no existe. Si no existe, no se realiza ninguna acción. Si existe, se elimina la base de datos.

Advertencia: se elimina toda la base de datos y no se realiza ningún esfuerzo para quitar solo los objetos de base de datos que usa el modelo para este contexto.

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

Parámetros

cancellationToken

CancellationToken

que CancellationToken se va a observar mientras espera a que se complete la tarea.

Devoluciones

Task<Boolean>

Tarea que representa la operación de guardado asincrónico. El resultado de la tarea contiene true si se elimina la base de datos, false si no existe.

Atributos

RequiresDynamicCodeAttribute

Excepciones

OperationCanceledException

Si se cancela CancellationToken.

Comentarios

Es habitual usar EnsureCreatedAsync(CancellationToken) inmediatamente después EnsureDeletedAsync(CancellationToken) al probar o crear prototipos mediante Entity Framework. Esto garantiza que la base de datos está en un estado limpio antes de cada ejecución del prototipo o prueba. Sin embargo, tenga en cuenta que los datos de la base de datos no se conservan.

Entity Framework Core no admite la ejecución de varias operaciones paralelas en la misma instancia de DbContext. Esto incluye la ejecución en paralelo de consultas asincrónicas y cualquier uso simultáneo explícito desde varios subprocesos. Por lo tanto, espere siempre llamadas asincrónicas inmediatamente o use instancias de DbContext independientes para las operaciones que se ejecutan en paralelo. Consulte Evitar problemas de subprocesos de DbContext para obtener más información y ejemplos.

Consulte Administración de esquemas de base de datos con EF Core y API de creación de bases de datos para obtener más información y ejemplos.