DbContext.AddAsync 方法

定义

命名空间:

Microsoft.EntityFrameworkCore

程序集:

Microsoft.EntityFrameworkCore.dll

程序包:

Microsoft.EntityFrameworkCore v10.0.0

重载

名称	说明
AddAsync(Object, CancellationToken)	开始跟踪给定实体，以及尚未跟踪的任何其他可访问实体， Added 以便在调用时 SaveChanges() 将其插入数据库。
AddAsync<TEntity>(TEntity, CancellationToken)	开始跟踪给定实体，以及尚未跟踪的任何其他可访问实体， Added 以便在调用时 SaveChanges() 将其插入数据库。

AddAsync(Object, CancellationToken)

Source:

DbContext.cs

开始跟踪给定实体，以及尚未跟踪的任何其他可访问实体， Added 以便在调用时 SaveChanges() 将其插入数据库。

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.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 ValueTask(Of EntityEntry)

参数

entity

Object

要添加的实体。

cancellationToken

CancellationToken

等待任务完成时观察的 A CancellationToken 。

返回

ValueTask<EntityEntry>

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

例外

OperationCanceledException

如果取消了该操作 CancellationToken 。

注解

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

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

Entity Framework Core不支持在同一 DbContext 实例上运行多个并行操作。 这包括异步查询的并行执行以及从多个线程进行的任何显式并发使用。 因此，请始终立即等待异步调用，或者对并行执行的操作使用单独的 DbContext 实例。 有关详细信息和示例，请参阅 避免 DbContext 线程问题 。

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

AddAsync<TEntity>(TEntity, CancellationToken)

Source:

DbContext.cs

开始跟踪给定实体，以及尚未跟踪的任何其他可访问实体， Added 以便在调用时 SaveChanges() 将其插入数据库。

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.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 ValueTask(Of EntityEntry(Of TEntity))

类型参数

TEntity

实体的类型。

参数

entity

TEntity

要添加的实体。

cancellationToken

CancellationToken

等待任务完成时观察的 A CancellationToken 。

返回

ValueTask<EntityEntry<TEntity>>

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

例外

OperationCanceledException

如果取消了该操作 CancellationToken 。

注解

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

Entity Framework Core不支持在同一 DbContext 实例上运行多个并行操作。 这包括异步查询的并行执行以及从多个线程进行的任何显式并发使用。 因此，请始终立即等待异步调用，或者对并行执行的操作使用单独的 DbContext 实例。 有关详细信息和示例，请参阅 避免 DbContext 线程问题 。

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