DbContext.AddRangeAsync 方法

定义

命名空间:

Microsoft.EntityFrameworkCore

程序集:

Microsoft.EntityFrameworkCore.dll

包:

Microsoft.EntityFrameworkCore v8.0.0

重载

AddRangeAsync(Object[])	开始跟踪给定实体，以及尚未跟踪的任何其他可访问实体， Added 状态为，以便在调用 时 SaveChanges() 将其插入数据库。
AddRangeAsync(IEnumerable<Object>, CancellationToken)	开始跟踪给定实体，以及尚未跟踪的任何其他可访问实体， Added 状态为，以便在调用 时 SaveChanges() 将其插入数据库。

AddRangeAsync(Object[])

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

public virtual System.Threading.Tasks.Task AddRangeAsync (params object[] entities);

abstract member AddRangeAsync : obj[] -> System.Threading.Tasks.Task
override this.AddRangeAsync : obj[] -> System.Threading.Tasks.Task

Public Overridable Function AddRangeAsync (ParamArray entities As Object()) As Task

参数

entities

Object[]

要添加的实体。

返回

Task

表示异步操作的任务。

注解

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

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

有关详细信息和示例，请参阅 EF Core 更改跟踪和使用 AddRange、UpdateRange、AttachRange 和 RemoveRange。

AddRangeAsync(IEnumerable<Object>, CancellationToken)

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

public virtual System.Threading.Tasks.Task AddRangeAsync (System.Collections.Generic.IEnumerable<object> entities, System.Threading.CancellationToken cancellationToken = default);

abstract member AddRangeAsync : seq<obj> * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.AddRangeAsync : seq<obj> * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Overridable Function AddRangeAsync (entities As IEnumerable(Of Object), Optional cancellationToken As CancellationToken = Nothing) As Task

参数

entities

IEnumerable<Object>

要添加的实体。

cancellationToken

CancellationToken

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

返回

Task

表示异步操作的任务。

例外

OperationCanceledException

如果已取消 CancellationToken。

注解

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

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

有关详细信息和示例，请参阅 EF Core 更改跟踪和使用 AddRange、UpdateRange、AttachRange 和 RemoveRange。