次の方法で共有


DbSet<TEntity>.AddAsync(TEntity, CancellationToken) メソッド

定義

が呼び出されたときに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タスクの完了を待機している間に観察する 。

戻り値

Task<EntityEntry<TEntity>>

非同期の追加操作を表すタスク。 タスクの結果には、エンティティの が EntityEntry<TEntity> 含まれます。 エントリは、エンティティの変更追跡情報と操作へのアクセスを提供します。

例外

CancellationToken が取り消されている場合。

注釈

このメソッドは、'Microsoft.EntityFrameworkCore.Metadata.SqlServerValueGenerationStrategy.SequenceHiLo' で使用される特殊な値ジェネレーターがデータベースに非同期的にアクセスできるようにする場合にのみ非同期です。 それ以外の場合は、非同期以外のメソッドを使用する必要があります。

を使用して State 、1 つのエンティティのみの状態を設定します。

詳細と例については、「 EF Core 変更の追跡 」を参照してください。

適用対象