DatabaseFacade.EnsureDeletedAsync(CancellationToken) Méthode

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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.

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.")]
public virtual System.Threading.Tasks.Task<bool> EnsureDeletedAsync (System.Threading.CancellationToken cancellationToken = default);

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

S’applique à

Partager via