DbContext.AddRangeAsync 方法

定义

命名空间:

Microsoft.EntityFrameworkCore

程序集:

Microsoft.EntityFrameworkCore.dll

程序包:

Microsoft.EntityFrameworkCore v10.0.0

重载

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

AddRangeAsync(Object[])

Source:

DbContext.cs

开始跟踪给定实体，以及尚未跟踪的任何其他可访问实体， 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)

Source:

DbContext.cs

开始跟踪给定实体，以及尚未跟踪的任何其他可访问实体， 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

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

返回

Task

表示异步操作的任务。

例外

OperationCanceledException

如果取消了该操作 CancellationToken 。

注解

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

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

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