DbContext.AddAsync 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.
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.Task<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry> AddAsync (object entity, System.Threading.CancellationToken cancellationToken = default);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.Task<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry>
override this.AddAsync : obj * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry>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 Task(Of 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
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
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 .
Si applica a
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.Task<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry<TEntity>> AddAsync<TEntity> (TEntity entity, System.Threading.CancellationToken cancellationToken = default) where TEntity : class;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.Task<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry<'Entity>> (requires 'Entity : null)
override this.AddAsync : 'Entity * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry<'Entity>> (requires 'Entity : null)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 Task(Of EntityEntry(Of TEntity))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
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.
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 .
