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 更改跟踪 。
