Язык

DatabaseFacade.EnsureCreatedAsync(CancellationToken) Метод

Определение

Гарантирует, что база данных для контекста существует.

public virtual System.Threading.Tasks.Task<bool> EnsureCreatedAsync(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> EnsureCreatedAsync(System.Threading.CancellationToken cancellationToken = default);
abstract member EnsureCreatedAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>
override this.EnsureCreatedAsync : 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 EnsureCreatedAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>
override this.EnsureCreatedAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>
Public Overridable Function EnsureCreatedAsync (Optional cancellationToken As CancellationToken = Nothing) As Task(Of Boolean)

Параметры

cancellationToken
CancellationToken

Необходимо CancellationToken наблюдать за ожиданием завершения задачи.

Возвращаемое значение

Задача, представляющая асинхронную операцию сохранения. Результат задачи содержит true , если база данных создана, false если она уже существует.

Атрибуты

Исключения

Если отменяется CancellationToken .

Комментарии

  • Если база данных существует и содержит таблицы, то никаких действий не выполняется. Ничего не делается для обеспечения совместимости схемы базы данных с моделью Entity Framework.
  • Если база данных существует, но не содержит таблиц, модель Entity Framework используется для создания схемы базы данных.
  • Если база данных не существует, создается база данных и модель Entity Framework используется для создания схемы базы данных.

Обычно при тестировании или создании прототипов с помощью Entity Framework используется немедленное EnsureDeletedAsync(CancellationToken) использованиеEnsureCreatedAsync(CancellationToken). Это гарантирует, что база данных находится в чистом состоянии перед каждым выполнением теста или прототипа. Обратите внимание, что данные в базе данных не сохраняются.

Обратите внимание, что этот API **не** использует миграции для создания базы данных. Кроме того, созданная база данных не может быть обновлена с помощью миграций. Если вы нацелены на реляционную базу данных и используете миграцию, можно использовать Microsoft.EntityFrameworkCore.RelationalDatabaseFacadeExtensions.MigrateAsync для обеспечения создания базы данных с помощью миграций и применения всех миграций.

Entity Framework Core не поддерживает несколько параллельных операций, выполняемых в одном экземпляре DbContext. включая параллельное выполнение асинхронных запросов и любое явное конкурентное использование из нескольких потоков. Поэтому всегда ожидайте асинхронные вызовы немедленно или используйте отдельные экземпляры DbContext для операций, выполняемых параллельно. Дополнительные сведения и примеры см. в разделе "Избегание проблем с потоком DbContext ".

Дополнительные сведения и примеры см. в разделе "Управление схемами баз данных с помощью API создания EF Core и базы данных ".

Применяется к