DbSet<TEntity>.AddAsync(TEntity, CancellationToken) Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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.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
Entita, která se má přidat.
- cancellationToken
- CancellationToken
A CancellationToken , která se má sledovat při čekání na dokončení úkolu.
Návraty
Ú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
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 .
Platí pro
Entity Framework