DatabaseFacade.EnsureCreated Méthode

Définition

Garantit l’existence de la base de données pour le contexte.

public virtual bool EnsureCreated ();
[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 bool EnsureCreated ();
abstract member EnsureCreated : unit -> bool
override this.EnsureCreated : unit -> 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 EnsureCreated : unit -> bool
override this.EnsureCreated : unit -> bool
Public Overridable Function EnsureCreated () As Boolean

Retours

true si la base de données est créée, false si elle existait déjà.

Attributs

Remarques

  • Si la base de données existe et contient des tables, aucune action n’est effectuée. Rien n’est fait pour garantir la compatibilité du schéma de base de données avec le modèle Entity Framework.
  • Si la base de données existe mais n’a pas de tables, le modèle Entity Framework est utilisé pour créer le schéma de base de données.
  • Si la base de données n’existe pas, la base de données est créée et le modèle Entity Framework est utilisé pour créer le schéma de base de données.

Il est courant d’utiliser EnsureCreated() immédiatement après EnsureDeleted() 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.

Notez que cette API **not** utilise des migrations pour créer la base de données. En outre, la base de données créée ne peut pas être mise à jour ultérieurement à l’aide de migrations. Si vous ciblez une base de données relationnelle et que vous utilisez des migrations, vous pouvez utiliser Microsoft.EntityFrameworkCore.RelationalDatabaseFacadeExtensions.Migrate pour vous assurer que la base de données est créée à l’aide de migrations et que toutes les migrations ont été appliquées.

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 à