Condividi tramite


DbSet<TEntity>.AddAsync(TEntity, CancellationToken) Metodo

Definizione

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

Parametri

entity
TEntity

Entità da aggiungere.

cancellationToken
CancellationToken

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

Restituisce

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

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.

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

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

Si applica a