DbContext.AddRangeAsync Metoda

Definicja

Przestrzeń nazw:

Microsoft.EntityFrameworkCore

Zestaw:

Microsoft.EntityFrameworkCore.dll

Pakiet:

Microsoft.EntityFrameworkCore v8.0.0

Przeciążenia

AddRangeAsync(Object[])	Rozpoczyna śledzenie danej jednostki, a wszystkie inne dostępne jednostki, które nie są jeszcze śledzone, w Added stanie tak, że zostaną one wstawione do bazy danych po SaveChanges() wywołaniu.
AddRangeAsync(IEnumerable<Object>, CancellationToken)	Rozpoczyna śledzenie danej jednostki, a wszystkie inne dostępne jednostki, które nie są jeszcze śledzone, w Added stanie tak, że zostaną one wstawione do bazy danych po SaveChanges() wywołaniu.

AddRangeAsync(Object[])

Rozpoczyna śledzenie danej jednostki, a wszystkie inne dostępne jednostki, które nie są jeszcze śledzone, w Added stanie tak, że zostaną one wstawione do bazy danych po SaveChanges() wywołaniu.

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

Parametry

entities

Object[]

Jednostki do dodania.

Zwraca

Task

Zadanie reprezentujące operację asynchroniczną.

Uwagi

Ta metoda jest asynchroniczna tylko w celu umożliwienia generatorom wartości specjalnych, takich jak ta używana przez metodę "Microsoft.EntityFrameworkCore.Metadata.SqlServerValueGenerationStrategy.SequenceHiLo", aby uzyskać dostęp do bazy danych asynchronicznie. W przypadku wszystkich innych przypadków należy użyć metody innej niż asynchronicznej.

Program Entity Framework Core nie obsługuje wielu równoległych operacji uruchamianych w tym samym wystąpieniu dbContext. Obejmuje to zarówno równoległe wykonywanie zapytań asynchronicznych, jak i wszelkie jawne współbieżne użycie z wielu wątków. W związku z tym zawsze czekaj na wywołania asynchroniczne natychmiast lub używaj oddzielnych wystąpień dbContext dla operacji wykonywanych równolegle. Aby uzyskać więcej informacji i przykładów, zobacz Unikanie problemów z wątkami dbContext .

Aby uzyskać więcej informacji i przykładów, zobacz Śledzenie zmian platformy EF Core i Używanie funkcji AddRange, UpdateRange, AttachRange i RemoveRange .

AddRangeAsync(IEnumerable<Object>, CancellationToken)

Rozpoczyna śledzenie danej jednostki, a wszystkie inne dostępne jednostki, które nie są jeszcze śledzone, w Added stanie tak, że zostaną one wstawione do bazy danych po SaveChanges() wywołaniu.

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

Parametry

entities

IEnumerable<Object>

Jednostki do dodania.

cancellationToken

CancellationToken

Element CancellationToken do obserwowania podczas oczekiwania na ukończenie zadania.

Zwraca

Task

Zadanie reprezentujące operację asynchroniczną.

Wyjątki

OperationCanceledException

Jeśli element CancellationToken zostanie anulowany.

Uwagi

Ta metoda jest asynchroniczna tylko w celu umożliwienia generatorom wartości specjalnych, takich jak ta używana przez metodę "Microsoft.EntityFrameworkCore.Metadata.SqlServerValueGenerationStrategy.SequenceHiLo", aby uzyskać dostęp do bazy danych asynchronicznie. W przypadku wszystkich innych przypadków należy użyć metody innej niż asynchronicznej.

Program Entity Framework Core nie obsługuje wielu równoległych operacji uruchamianych w tym samym wystąpieniu dbContext. Obejmuje to zarówno równoległe wykonywanie zapytań asynchronicznych, jak i wszelkie jawne współbieżne użycie z wielu wątków. W związku z tym zawsze czekaj na wywołania asynchroniczne natychmiast lub używaj oddzielnych wystąpień dbContext dla operacji wykonywanych równolegle. Aby uzyskać więcej informacji i przykładów, zobacz Unikanie problemów z wątkami dbContext .

Aby uzyskać więcej informacji i przykładów, zobacz Śledzenie zmian platformy EF Core i Używanie funkcji AddRange, UpdateRange, AttachRange i RemoveRange .