DbContext.AddAsync 方法

定义

重载

AddAsync(Object, CancellationToken)

开始跟踪给定实体,以及在状态中未被跟踪的任何其他可访问实体,以便在 Added 调用时将其插入到数据库中 SaveChanges()

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

此方法只是允许使用特殊值生成器,如 "Microsoft.entityframeworkcore" 使用的生成器,以便以异步方式访问数据库。 对于所有其他情况,应使用非异步方法。

AddAsync<TEntity>(TEntity, CancellationToken)

开始跟踪给定实体,以及在状态中未被跟踪的任何其他可访问实体,以便在 Added 调用时将其插入到数据库中 SaveChanges()

此方法只是允许使用特殊值生成器,如 "Microsoft.entityframeworkcore" 使用的生成器,以便以异步方式访问数据库。 对于所有其他情况,应使用非异步方法。

AddAsync(Object, CancellationToken)

开始跟踪给定实体,以及在状态中未被跟踪的任何其他可访问实体,以便在 Added 调用时将其插入到数据库中 SaveChanges()

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

此方法只是允许使用特殊值生成器,如 "Microsoft.entityframeworkcore" 使用的生成器,以便以异步方式访问数据库。 对于所有其他情况,应使用非异步方法。

public virtual System.Threading.Tasks.Task<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry> AddAsync (object entity, System.Threading.CancellationToken cancellationToken = default);
public virtual System.Threading.Tasks.ValueTask<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry> AddAsync (object entity, System.Threading.CancellationToken cancellationToken = default);
abstract member AddAsync : obj * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry>
override this.AddAsync : obj * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry>
abstract member AddAsync : obj * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry>
override this.AddAsync : obj * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry>
Public Overridable Function AddAsync (entity As Object, Optional cancellationToken As CancellationToken = Nothing) As Task(Of EntityEntry)
Public Overridable Function AddAsync (entity As Object, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of EntityEntry)

参数

entity
Object

要添加的实体。

cancellationToken
CancellationToken

CancellationToken等待任务完成期间要观察的。

返回

Task<EntityEntry>
ValueTask<EntityEntry>

表示异步添加操作的任务。 任务结果包含实体的 EntityEntry 。 该条目提供对实体的更改跟踪信息和操作的访问权限。

适用于

AddAsync<TEntity>(TEntity, CancellationToken)

开始跟踪给定实体,以及在状态中未被跟踪的任何其他可访问实体,以便在 Added 调用时将其插入到数据库中 SaveChanges()

此方法只是允许使用特殊值生成器,如 "Microsoft.entityframeworkcore" 使用的生成器,以便以异步方式访问数据库。 对于所有其他情况,应使用非异步方法。

public virtual System.Threading.Tasks.Task<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry<TEntity>> AddAsync<TEntity> (TEntity entity, System.Threading.CancellationToken cancellationToken = default) where TEntity : class;
public virtual System.Threading.Tasks.ValueTask<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry<TEntity>> AddAsync<TEntity> (TEntity entity, System.Threading.CancellationToken cancellationToken = default) where TEntity : class;
abstract member AddAsync : 'Entity * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry<'Entity>> (requires 'Entity : null)
override this.AddAsync : 'Entity * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry<'Entity>> (requires 'Entity : null)
abstract member AddAsync : 'Entity * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry<'Entity>> (requires 'Entity : null)
override this.AddAsync : 'Entity * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry<'Entity>> (requires 'Entity : null)
Public Overridable Function AddAsync(Of TEntity As Class) (entity As TEntity, Optional cancellationToken As CancellationToken = Nothing) As Task(Of EntityEntry(Of TEntity))
Public Overridable Function AddAsync(Of TEntity As Class) (entity As TEntity, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of EntityEntry(Of TEntity))

类型参数

TEntity

实体的类型。

参数

entity
TEntity

要添加的实体。

cancellationToken
CancellationToken

CancellationToken等待任务完成期间要观察的。

返回

Task<EntityEntry<TEntity>>
ValueTask<EntityEntry<TEntity>>

表示异步添加操作的任务。 任务结果包含实体的 EntityEntry<TEntity> 。 该条目提供对实体的更改跟踪信息和操作的访问权限。

适用于