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
A CancellationToken 在等待任務完成時觀察。
傳回
Task<EntityEntry<TEntity>>
ValueTask<EntityEntry<TEntity>>
一個代表非同步加法操作的任務。 任務結果包含該實體的 。EntityEntry<TEntity> 該條目提供實體的變更追蹤資訊及營運權限。
例外狀況
備註
此方法僅為非同步,以允許特殊值產生器,例如「Microsoft」所使用的。EntityFrameworkCore.Metadata.SqlServerValueGenerationStrategy.SequenceHiLo',以非同步方式存取資料庫。 其他情況應使用非同步方法。
用 State 來設定單一實體的狀態。
更多資訊與範例請參閱 EF Core 變更追蹤 。