語言

DbSet<TEntity>.AddAsync(TEntity, CancellationToken) 方法

定義

開始追蹤指定實體及尚未被追蹤 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

A CancellationToken 在等待任務完成時觀察。

傳回

Task<EntityEntry<TEntity>>

一個代表非同步加法操作的任務。 任務結果包含該實體的 。EntityEntry<TEntity> 該條目提供實體的變更追蹤資訊及營運權限。

例外狀況

備註

此方法僅為非同步,以允許特殊值產生器,例如「Microsoft」所使用的。EntityFrameworkCore.Metadata.SqlServerValueGenerationStrategy.SequenceHiLo',以非同步方式存取資料庫。 其他情況應使用非同步方法。

用 State 來設定單一實體的狀態。

更多資訊與範例請參閱 EF Core 變更追蹤 。

適用於