DbContext.AddAsync Metoda

Definice

Obor názvů:

Microsoft.EntityFrameworkCore

Sestavení:

Microsoft.EntityFrameworkCore.dll

Balíček:

Microsoft.EntityFrameworkCore v9.0.0

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)

Zdroj:

DbContext.cs

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.ValueTask<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry> AddAsync (object entity, System.Threading.CancellationToken cancellationToken = default);

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 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

ValueTask<EntityEntry>

Ú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

OperationCanceledException

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 .

AddAsync<TEntity>(TEntity, CancellationToken)

Zdroj:

DbContext.cs

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.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.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 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

ValueTask<EntityEntry<TEntity>>

Ú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

OperationCanceledException

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 .