DbSet<TEntity>.AddAsync(TEntity, CancellationToken) Metoda

Odwołanie

Definicja

Przestrzeń nazw:: Microsoft.EntityFrameworkCore

Zestaw:: Microsoft.EntityFrameworkCore.dll

Pakiet:: Microsoft.EntityFrameworkCore v1.1.6

Pakiet:: Microsoft.EntityFrameworkCore v2.0.3

Pakiet:: Microsoft.EntityFrameworkCore v2.1.11

Pakiet:: Microsoft.EntityFrameworkCore v2.2.6

Pakiet:: Microsoft.EntityFrameworkCore v3.0.0

Pakiet:: Microsoft.EntityFrameworkCore v3.1.0

Pakiet:: Microsoft.EntityFrameworkCore v5.0.0

Pakiet:: Microsoft.EntityFrameworkCore v6.0.0

Pakiet:: Microsoft.EntityFrameworkCore v7.0.0

Pakiet:: Microsoft.EntityFrameworkCore v8.0.0

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Rozpoczyna śledzenie danej jednostki i innych osiągalnych jednostek, które nie są jeszcze śledzone, w Added stanie, w którym zostaną one wstawione do bazy danych po SaveChanges() wywołaniu.

public virtual System.Threading.Tasks.Task<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry<TEntity>> AddAsync (TEntity entity, System.Threading.CancellationToken cancellationToken = default);

public virtual System.Threading.Tasks.ValueTask<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry<TEntity>> AddAsync (TEntity entity, System.Threading.CancellationToken cancellationToken = default);

abstract member AddAsync : 'Entity * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry<'Entity>>
override this.AddAsync : 'Entity * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry<'Entity>>

abstract member AddAsync : 'Entity * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry<'Entity>>
override this.AddAsync : 'Entity * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry<'Entity>>

Public Overridable Function AddAsync (entity As TEntity, Optional cancellationToken As CancellationToken = Nothing) As Task(Of EntityEntry(Of TEntity))

Public Overridable Function AddAsync (entity As TEntity, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of EntityEntry(Of TEntity))

Parametry

entity: TEntity

Jednostka do dodania.

cancellationToken: CancellationToken

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

Zwraca

Task<EntityEntry<TEntity>>

ValueTask<EntityEntry<TEntity>>

Zadanie reprezentujące asynchroniczną operację Dodaj. Wynik zadania zawiera element EntityEntry<TEntity> dla jednostki. Wpis zapewnia dostęp do informacji i operacji śledzenia zmian dla jednostki.

Wyjątki

OperationCanceledException

Jeśli element CancellationToken zostanie anulowany.

Uwagi

Ta metoda jest asynchroniczna tylko w celu zezwolenia na generatory wartości specjalnych, takich jak ta używana przez element "Microsoft.EntityFrameworkCore.Metadata.SqlServerValueGenerationStrategy.SequenceHiLo", aby uzyskać dostęp do bazy danych asynchronicznie. W przypadku wszystkich pozostałych przypadków należy użyć metody innej niż asynchroniczna.

Służy State do ustawiania stanu tylko jednej jednostki.

Aby uzyskać więcej informacji i przykłady, zobacz Śledzenie zmian platformy EF Core .

Dotyczy