DatabaseFacade.EnsureCreatedAsync(CancellationToken) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
コンテキストのデータベースが存在することを確認します。
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 スレッドの問題の回避に 関するページを参照してください。
詳細と例については、「EF Core およびデータベース作成 API を使用したデータベース スキーマの管理」を参照してください。