DbContext.AddAsync メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
| AddAsync(Object, CancellationToken) |
が呼び出されたときにSaveChanges()データベースに挿入されるように、指定されたエンティティと、Addedまだ追跡されていないその他の到達可能なエンティティの追跡を開始します。 |
| AddAsync<TEntity>(TEntity, CancellationToken) |
が呼び出されたときにSaveChanges()データベースに挿入されるように、指定されたエンティティと、Addedまだ追跡されていないその他の到達可能なエンティティの追跡を開始します。 |
AddAsync(Object, CancellationToken)
が呼び出されたときにSaveChanges()データベースに挿入されるように、指定されたエンティティと、Addedまだ追跡されていないその他の到達可能なエンティティの追跡を開始します。
public virtual System.Threading.Tasks.Task<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry> AddAsync (object entity, System.Threading.CancellationToken cancellationToken = default);public virtual System.Threading.Tasks.ValueTask<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry> AddAsync (object entity, System.Threading.CancellationToken cancellationToken = default);abstract member AddAsync : obj * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry>
override this.AddAsync : obj * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry>abstract member AddAsync : obj * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry>
override this.AddAsync : obj * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry>Public Overridable Function AddAsync (entity As Object, Optional cancellationToken As CancellationToken = Nothing) As Task(Of EntityEntry)Public Overridable Function AddAsync (entity As Object, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of EntityEntry)パラメーター
- entity
- Object
追加するエンティティ。
- cancellationToken
- CancellationToken
CancellationTokenタスクの完了を待機している間に観察する 。
戻り値
非同期の追加操作を表すタスク。 タスクの結果には、エンティティの が EntityEntry 含まれます。 エントリは、エンティティの変更追跡情報と操作へのアクセスを提供します。
例外
CancellationToken が取り消されている場合。
注釈
を使用して State 、1 つのエンティティのみの状態を設定します。
このメソッドは、'Microsoft.EntityFrameworkCore.Metadata.SqlServerValueGenerationStrategy.SequenceHiLo' で使用される特殊な値ジェネレーターがデータベースに非同期的にアクセスできるようにする場合にのみ非同期です。 それ以外の場合は、非同期以外のメソッドを使用する必要があります。
Entity Framework Core では、同じ DbContext インスタンスで複数の並列操作を実行することはできません。 これには、非同期クエリの並列実行と、複数のスレッドからの明示的な同時使用の両方が含まれます。 そのため、非同期呼び出しは常にすぐに待機するか、並列で実行される操作には個別の DbContext インスタンスを使用します。 詳細と例については、「 DbContext スレッドの問題を回避する 」を参照してください。
詳細と例については、「 EF Core 変更の追跡 」を参照してください。
適用対象
AddAsync<TEntity>(TEntity, CancellationToken)
が呼び出されたときにSaveChanges()データベースに挿入されるように、指定されたエンティティと、Addedまだ追跡されていないその他の到達可能なエンティティの追跡を開始します。
public virtual System.Threading.Tasks.Task<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry<TEntity>> AddAsync<TEntity> (TEntity entity, System.Threading.CancellationToken cancellationToken = default) where TEntity : class;public virtual System.Threading.Tasks.ValueTask<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry<TEntity>> AddAsync<TEntity> (TEntity entity, System.Threading.CancellationToken cancellationToken = default) where TEntity : class;abstract member AddAsync : 'Entity * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry<'Entity>> (requires 'Entity : null)
override this.AddAsync : 'Entity * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry<'Entity>> (requires 'Entity : null)abstract member AddAsync : 'Entity * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry<'Entity>> (requires 'Entity : null)
override this.AddAsync : 'Entity * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry<'Entity>> (requires 'Entity : null)Public Overridable Function AddAsync(Of TEntity As Class) (entity As TEntity, Optional cancellationToken As CancellationToken = Nothing) As Task(Of EntityEntry(Of TEntity))Public Overridable Function AddAsync(Of TEntity As Class) (entity As TEntity, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of EntityEntry(Of TEntity))型パラメーター
- TEntity
エンティティの種類。
パラメーター
- entity
- TEntity
追加するエンティティ。
- cancellationToken
- CancellationToken
CancellationTokenタスクの完了を待機している間に観察する 。
戻り値
非同期の追加操作を表すタスク。 タスクの結果には、エンティティの が EntityEntry<TEntity> 含まれます。 エントリは、エンティティの変更追跡情報と操作へのアクセスを提供します。
例外
CancellationToken が取り消されている場合。
注釈
このメソッドは、'Microsoft.EntityFrameworkCore.Metadata.SqlServerValueGenerationStrategy.SequenceHiLo' で使用される特殊な値ジェネレーターがデータベースに非同期的にアクセスできるようにする場合にのみ非同期です。 それ以外の場合は、非同期以外のメソッドを使用する必要があります。
Entity Framework Core では、同じ DbContext インスタンスで複数の並列操作を実行することはできません。 これには、非同期クエリの並列実行と、複数のスレッドからの明示的な同時使用の両方が含まれます。 そのため、非同期呼び出しは常にすぐに待機するか、並列で実行される操作には個別の DbContext インスタンスを使用します。 詳細と例については、「 DbContext スレッドの問題を回避する 」を参照してください。
詳細と例については、「 EF Core 変更の追跡 」を参照してください。
適用対象
Entity Framework