语言

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> 实体。 该条目提供对实体的更改跟踪信息和操作的访问权限。

例外

如果取消了该操作 CancellationToken 。

注解

此方法只是为了允许特殊值生成器(例如'Microsoft使用的生成器)而异步。EntityFrameworkCore.Metadata.SqlServerValueGenerationStrategy.SequenceHiLo',用于异步访问数据库。 对于所有其他情况,应使用非异步方法。

用于 State 仅设置单个实体的状态。

有关详细信息和示例,请参阅 EF Core 更改跟踪 。

适用于