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等待任务完成期间要观察的。
返回
表示异步添加操作的任务。 任务结果包含实体的 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> 。 该条目提供对实体的更改跟踪信息和操作的访问权限。