DatabaseFacade.EnsureDeletedAsync(CancellationToken) Méthode

Définition

Espace de noms:

Microsoft.EntityFrameworkCore.Infrastructure

Assembly:

Microsoft.EntityFrameworkCore.dll

Paquet:

Microsoft.EntityFrameworkCore v8.0.0

Garantit de manière asynchrone que la base de données du contexte n’existe pas. S’il n’existe pas, aucune action n’est prise. Si elle existe, la base de données est supprimée.

Avertissement : la base de données entière est supprimée et aucun effort n’est fait pour supprimer uniquement les objets de base de données utilisés par le modèle pour ce contexte.

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

Paramètres

cancellationToken

CancellationToken

CancellationToken À observer en attendant la fin de la tâche.

Retours

Task<Boolean>

Tâche qui représente l’opération d’écriture d’enregistrement asynchrone. Le résultat de la tâche indique true si la base de données est supprimée, false si elle n’existait pas.

Attributs

RequiresDynamicCodeAttribute

Exceptions

OperationCanceledException

Si le CancellationToken est annulé.

Remarques

Il est courant d’utiliser EnsureCreatedAsync(CancellationToken) immédiatement après EnsureDeletedAsync(CancellationToken) lors du test ou du prototypage à l’aide d’Entity Framework. Cela garantit que la base de données est dans un état propre avant chaque exécution du test/prototype. Notez toutefois que les données de la base de données ne sont pas conservées.

Entity Framework Core ne prend pas en charge plusieurs opérations parallèles exécutées sur le même instance DbContext. Cela inclut l’exécution parallèle de requêtes asynchrones et toute utilisation simultanée explicite de plusieurs threads. Par conséquent, attendez toujours immédiatement les appels asynchrones ou utilisez des instances DbContext distinctes pour les opérations qui s’exécutent en parallèle. Pour plus d’informations et d’exemples, consultez Éviter les problèmes de thread dbContext .

Pour plus d’informations et d’exemples, consultez Gestion des schémas de base de données avec EF Core et les API de création de base de données.