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 и базы данных ".