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