DbContext.AddRangeAsync メソッド

定義

名前空間:

Microsoft.EntityFrameworkCore

アセンブリ:

Microsoft.EntityFrameworkCore.dll

パッケージ:

Microsoft.EntityFrameworkCore v9.0.0

オーバーロード

AddRangeAsync(Object[])	が呼び出されたときにSaveChanges()データベースに挿入されるように、指定されたAddedエンティティと、まだ追跡されていない他の到達可能なエンティティの追跡を開始します。
AddRangeAsync(IEnumerable<Object>, CancellationToken)	が呼び出されたときにSaveChanges()データベースに挿入されるように、指定されたAddedエンティティと、まだ追跡されていない他の到達可能なエンティティの追跡を開始します。

AddRangeAsync(Object[])

ソース:

DbContext.cs

が呼び出されたときにSaveChanges()データベースに挿入されるように、指定されたAddedエンティティと、まだ追跡されていない他の到達可能なエンティティの追跡を開始します。

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)

ソース:

DbContext.cs

が呼び出されたときにSaveChanges()データベースに挿入されるように、指定されたAddedエンティティと、まだ追跡されていない他の到達可能なエンティティの追跡を開始します。

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 の使用 」を参照してください。