DbContext.AddAsync 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í.
Přetížení
| AddAsync(Object, CancellationToken) |
Začne sledovat danou entitu a všechny ostatní dosažitelné entity, které se ještě nesledují, ve Added stavu, který při zavolání vloží do databáze SaveChanges() . |
| AddAsync<TEntity>(TEntity, CancellationToken) |
Začne sledovat danou entitu a všechny ostatní dosažitelné entity, které se ještě nesledují, ve Added stavu, který při zavolání vloží do databáze SaveChanges() . |
AddAsync(Object, CancellationToken)
Začne sledovat danou entitu a všechny ostatní dosažitelné entity, které se ještě nesledují, ve Added stavu, který při zavolání vloží do databáze SaveChanges() .
public virtual System.Threading.Tasks.Task<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry> AddAsync (object entity, System.Threading.CancellationToken cancellationToken = default);public virtual System.Threading.Tasks.ValueTask<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry> AddAsync (object entity, System.Threading.CancellationToken cancellationToken = default);abstract member AddAsync : obj * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry>
override this.AddAsync : obj * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry>abstract member AddAsync : obj * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry>
override this.AddAsync : obj * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry>Public Overridable Function AddAsync (entity As Object, Optional cancellationToken As CancellationToken = Nothing) As Task(Of EntityEntry)Public Overridable Function AddAsync (entity As Object, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of EntityEntry)Parametry
- entity
- Object
Entita, která se má přidat.
- cancellationToken
- CancellationToken
K CancellationToken pozorování při čekání na dokončení úlohy.
Návraty
Úloha, která představuje asynchronní operaci Add. Výsledek úkolu obsahuje EntityEntry 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
Slouží State k nastavení stavu pouze jedné entity.
Tato metoda je asynchronní pouze k povolení speciálních hodnot generátorů, jako je 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.
Entity Framework Core nepodporuje spouštění více paralelních operací ve stejné instanci DbContext. To zahrnuje paralelní spouštění asynchronních dotazů i jakékoli explicitní souběžné používání z více vláken. Proto vždy okamžitě vyčkejte na asynchronní volání nebo pro paralelně spouštěné operace používejte samostatné instance DbContext. Další informace a příklady najdete v tématu Zabránění problémům s vytvářením vláken DbContext .
Další informace a příklady najdete v tématu Sledování změn EF Core .
Platí pro
AddAsync<TEntity>(TEntity, CancellationToken)
Začne sledovat danou entitu a všechny ostatní dosažitelné entity, které se ještě nesledují, ve Added stavu, který při zavolání vloží do databáze SaveChanges() .
public virtual System.Threading.Tasks.Task<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry<TEntity>> AddAsync<TEntity> (TEntity entity, System.Threading.CancellationToken cancellationToken = default) where TEntity : class;public virtual System.Threading.Tasks.ValueTask<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry<TEntity>> AddAsync<TEntity> (TEntity entity, System.Threading.CancellationToken cancellationToken = default) where TEntity : class;abstract member AddAsync : 'Entity * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry<'Entity>> (requires 'Entity : null)
override this.AddAsync : 'Entity * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry<'Entity>> (requires 'Entity : null)abstract member AddAsync : 'Entity * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry<'Entity>> (requires 'Entity : null)
override this.AddAsync : 'Entity * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry<'Entity>> (requires 'Entity : null)Public Overridable Function AddAsync(Of TEntity As Class) (entity As TEntity, Optional cancellationToken As CancellationToken = Nothing) As Task(Of EntityEntry(Of TEntity))Public Overridable Function AddAsync(Of TEntity As Class) (entity As TEntity, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of EntityEntry(Of TEntity))Parametry typu
- TEntity
Typ entity.
Parametry
- entity
- TEntity
Entita, která se má přidat.
- cancellationToken
- CancellationToken
K CancellationToken pozorování při čekání na dokončení úlohy.
Návraty
Úloha, která představuje asynchronní operaci Add. Výsledek úkolu obsahuje EntityEntry<TEntity> 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 k povolení speciálních hodnot generátorů, jako je 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.
Entity Framework Core nepodporuje spouštění více paralelních operací ve stejné instanci DbContext. To zahrnuje paralelní spouštění asynchronních dotazů i jakékoli explicitní souběžné používání z více vláken. Proto vždy okamžitě vyčkejte na asynchronní volání nebo pro paralelně spouštěné operace používejte samostatné instance DbContext. Další informace a příklady najdete v tématu Zabránění problémům s vytvářením vláken DbContext .
Další informace a příklady najdete v tématu Sledování změn EF Core .
Platí pro
Entity Framework