DbContext.AddAsync Metodo

Definizione

Spazio dei nomi:

Microsoft.EntityFrameworkCore

Assembly:

Microsoft.EntityFrameworkCore.dll

Pacchetto:

Microsoft.EntityFrameworkCore v8.0.0

Overload

AddAsync(Object, CancellationToken)	Inizia a tenere traccia dell'entità specificata e a tutte le altre entità raggiungibili che non vengono già rilevate, nello Added stato in modo che vengano inserite nel database quando SaveChanges() viene chiamato.
AddAsync<TEntity>(TEntity, CancellationToken)	Inizia a tenere traccia dell'entità specificata e a tutte le altre entità raggiungibili che non vengono già rilevate, nello Added stato in modo che vengano inserite nel database quando SaveChanges() viene chiamato.

AddAsync(Object, CancellationToken)

Inizia a tenere traccia dell'entità specificata e a tutte le altre entità raggiungibili che non vengono già rilevate, nello Added stato in modo che vengano inserite nel database quando SaveChanges() viene chiamato.

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)

Parametri

entity

Object

Entità da aggiungere.

cancellationToken

CancellationToken

Oggetto CancellationToken da osservare durante l'attesa del completamento dell'attività.

Restituisce

ValueTask<EntityEntry>

Attività che rappresenta l'operazione Di aggiunta asincrona. Il risultato dell'attività contiene l'oggetto EntityEntry per l'entità. La voce fornisce l'accesso alle informazioni e alle operazioni di rilevamento delle modifiche per l'entità.

Eccezioni

OperationCanceledException

Se CancellationToken viene annullato.

Commenti

Usare State per impostare lo stato di una sola entità.

Questo metodo è asincrono solo per consentire ai generatori di valori speciali, ad esempio quello usato da 'Microsoft.EntityFrameworkCore.Metadata.SqlServerValueGenerationStrategy.SequenceHiLo', di accedere al database in modo asincrono. Per tutti gli altri casi è consigliabile usare il metodo non asincrono.

Entity Framework Core non supporta l'esecuzione di più operazioni parallele nella stessa istanza di DbContext. Ciò include sia l'esecuzione parallela di query asincrone che qualsiasi uso simultaneo esplicito da più thread. Pertanto, attendono sempre immediatamente le chiamate asincrone o usano istanze DbContext separate per le operazioni eseguite in parallelo. Per altre informazioni ed esempi, vedere Evitare problemi di threading DbContext .

Per altre informazioni ed esempi, vedere Rilevamento modifiche di EF Core .

AddAsync<TEntity>(TEntity, CancellationToken)

Inizia a tenere traccia dell'entità specificata e a tutte le altre entità raggiungibili che non vengono già rilevate, nello Added stato in modo che vengano inserite nel database quando SaveChanges() viene chiamato.

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

Parametri di tipo

TEntity

Tipo dell'entità.

Parametri

entity

TEntity

Entità da aggiungere.

cancellationToken

CancellationToken

Oggetto CancellationToken da osservare durante l'attesa del completamento dell'attività.

Restituisce

ValueTask<EntityEntry<TEntity>>

Attività che rappresenta l'operazione Di aggiunta asincrona. Il risultato dell'attività contiene l'oggetto EntityEntry<TEntity> per l'entità. La voce fornisce l'accesso alle informazioni e alle operazioni di rilevamento delle modifiche per l'entità.

Eccezioni

OperationCanceledException

Se CancellationToken viene annullato.

Commenti

Questo metodo è asincrono solo per consentire ai generatori di valori speciali, ad esempio quello usato da 'Microsoft.EntityFrameworkCore.Metadata.SqlServerValueGenerationStrategy.SequenceHiLo', di accedere al database in modo asincrono. Per tutti gli altri casi è consigliabile usare il metodo non asincrono.

Entity Framework Core non supporta l'esecuzione di più operazioni parallele nella stessa istanza di DbContext. Ciò include sia l'esecuzione parallela di query asincrone che qualsiasi uso simultaneo esplicito da più thread. Pertanto, attendono sempre immediatamente le chiamate asincrone o usano istanze DbContext separate per le operazioni eseguite in parallelo. Per altre informazioni ed esempi, vedere Evitare problemi di threading DbContext .

Per altre informazioni ed esempi, vedere Rilevamento modifiche di EF Core .