DbSet<TEntity>.AddAsync(TEntity, CancellationToken) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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
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
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 .
