DbContext.AddAsync Metoda

Definice

Obor názvů:

Microsoft.EntityFrameworkCore

Sestavení:

Microsoft.EntityFrameworkCore.dll

Balíček:

Microsoft.EntityFrameworkCore v10.0.0

Přetížení

Název	Description
AddAsync(Object, CancellationToken)	Začne sledovat danou entitu a všechny další dosažitelné entity, které se ještě nesledují, ve Added stavu tak, že se při zavolání vloží do databáze SaveChanges() .
AddAsync<TEntity>(TEntity, CancellationToken)	Začne sledovat danou entitu a všechny další dosažitelné entity, které se ještě nesledují, ve Added stavu tak, že se při zavolání vloží do databáze SaveChanges() .

AddAsync(Object, CancellationToken)

Zdroj:

DbContext.cs

Začne sledovat danou entitu a všechny další dosažitelné entity, které se ještě nesledují, ve Added stavu tak, že se 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

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

Návraty

ValueTask<EntityEntry>

Úkol, který představuje asynchronní operaci Přidat. Výsledek úkolu obsahuje entitu EntityEntry . Tato položka poskytuje přístup k informacím a operacím sledování změn pro entitu.

Výjimky

OperationCanceledException

Pokud je zrušena CancellationToken .

Poznámky

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

Tato metoda je asynchronní pouze pro povolení generátorů speciálních hodnot, jako je například ten, který používá "Microsoft". EntityFrameworkCore.Metadata.SqlServerValueGenerationStrategy.SequenceHiLo' pro asynchronní přístup k databázi. Pro všechny ostatní případy 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 čekejte asynchronní volání okamžitě nebo použijte samostatné instance DbContext pro operace, které se spouští paralelně. Další informace a příklady najdete v tématu Zabránění problémům s vlákny DbContext .

Další informace a příklady najdete v tématu EF Core Change Tracking .

AddAsync<TEntity>(TEntity, CancellationToken)

Zdroj:

DbContext.cs

Začne sledovat danou entitu a všechny další dosažitelné entity, které se ještě nesledují, ve Added stavu tak, že se 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

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

Návraty

ValueTask<EntityEntry<TEntity>>

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

Výjimky

OperationCanceledException

Pokud je zrušena CancellationToken .

Poznámky

Tato metoda je asynchronní pouze pro povolení generátorů speciálních hodnot, jako je například ten, který používá "Microsoft". EntityFrameworkCore.Metadata.SqlServerValueGenerationStrategy.SequenceHiLo' pro asynchronní přístup k databázi. Pro všechny ostatní případy 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 čekejte asynchronní volání okamžitě nebo použijte samostatné instance DbContext pro operace, které se spouští paralelně. Další informace a příklady najdete v tématu Zabránění problémům s vlákny DbContext .

Další informace a příklady najdete v tématu EF Core Change Tracking .