DatabaseFacade.EnsureCreated Método

Definição

Namespace:

Microsoft.EntityFrameworkCore.Infrastructure

Assembly:

Microsoft.EntityFrameworkCore.dll

Pacote:

Microsoft.EntityFrameworkCore v8.0.0

Garante que o banco de dados para o contexto exista.

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

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

Retornos

Boolean

true se o banco de dados for criado, false se ele já existir.

Atributos

RequiresDynamicCodeAttribute

Comentários

• Se o banco de dados existir e tiver tabelas, nenhuma ação será tomada. Nada é feito para garantir que o esquema de banco de dados seja compatível com o modelo do Entity Framework.
• Se o banco de dados existir, mas não tiver tabelas, o modelo do Entity Framework será usado para criar o esquema de banco de dados.
• Se o banco de dados não existir, o banco de dados será criado e o modelo do Entity Framework será usado para criar o esquema de banco de dados.

É comum usar EnsureCreated() imediatamente a seguir EnsureDeleted() ao testar ou criar protótipos usando o Entity Framework. Isso garante que o banco de dados esteja em um estado limpo antes de cada execução do teste/protótipo. Observe, no entanto, que os dados no banco de dados não são preservados.

Observe que essa API usa **not** migrações para criar o banco de dados. Além disso, o banco de dados criado não pode ser atualizado posteriormente usando migrações. Se você estiver direcionando um banco de dados relacional e usando migrações, poderá usar Microsoft.EntityFrameworkCore.RelationalDatabaseFacadeExtensions.Migrate para garantir que o banco de dados seja criado usando migrações e que todas as migrações tenham sido aplicadas.

Consulte Gerenciando esquemas de banco de dados comAPIs de criação de banco de dados e EF Core para obter mais informações e exemplos.