DbSet<TEntity>.AddAsync(TEntity, CancellationToken) 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
開始追蹤指定的實體，以及尚未追蹤的任何其他可連線實體，處於狀態， Added 以便在呼叫 時 SaveChanges() 將它們插入資料庫。
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>>
ValueTask<EntityEntry<TEntity>>
表示非同步新增作業的工作。 工作結果包含 EntityEntry<TEntity> 實體的 。 專案可讓您存取實體的變更追蹤資訊和作業。
例外狀況
備註
這個方法是非同步，只允許特殊值產生器，例如 'Microsoft.EntityFrameworkCore.Metadata.SqlServerValueGenerationStrategy.SequenceHiLo' 用來以非同步方式存取資料庫。 對於所有其他情況，應該使用非非同步方法。
使用 State 僅設定單一實體的狀態。
如需詳細資訊和範例，請參閱 EF Core 變更追蹤 。
