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

Definizione

Spazio dei nomi:

Microsoft.EntityFrameworkCore

Assembly:

Microsoft.EntityFrameworkCore.dll

Pacchetto:

Microsoft.EntityFrameworkCore v8.0.0

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 entity, System.Threading.CancellationToken cancellationToken = default);

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

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.

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

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