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 。