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

Definice

Obor názvů:

Microsoft.EntityFrameworkCore

Sestavení:

Microsoft.EntityFrameworkCore.dll

Balíček:

Microsoft.EntityFrameworkCore v8.0.0

Začne sledovat danou entitu a všechny další dostupné entity, které ještě nejsou sledovány, ve Added stavu, kdy se při zavolání vloží do databáze SaveChanges() .

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.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 ValueTask(Of EntityEntry(Of TEntity))

Parametry

entity

TEntity

Entita, která se má přidat.

cancellationToken

CancellationToken

A CancellationToken , která se má sledovat při čekání na dokončení úkolu.

Návraty

ValueTask<EntityEntry<TEntity>>

Úloha, která představuje asynchronní operaci Add. Výsledek úkolu obsahuje EntityEntry<TEntity> hodnotu pro entitu. Položka poskytuje přístup k informacím a operacím sledování změn pro entitu.

Výjimky

OperationCanceledException

CancellationToken Pokud je zrušena.

Poznámky

Tato metoda je asynchronní pouze pro povolení speciálních generátorů hodnot, jako je například ten, který používá "Microsoft.EntityFrameworkCore.Metadata.SqlServerValueGenerationStrategy.SequenceHiLo", přistupovat k databázi asynchronně. Ve všech ostatních případech by se měla použít nesynchronní metoda.

Slouží State k nastavení stavu pouze jedné entity.

Další informace a příklady najdete v tématu Sledování změn EF Core .