DbSet<TEntity>.AddAsync(TEntity, CancellationToken) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Commence le suivi de l’entité donnée et de toutes les autres entités accessibles qui ne sont pas encore suivies, dans l’état Added de sorte qu’elles soient insérées dans la base de données quand SaveChanges() est appelée.
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))Paramètres
- entity
- TEntity
Entité à ajouter.
- cancellationToken
- CancellationToken
CancellationToken À observer en attendant la fin de la tâche.
Retours
Tâche qui représente l’opération d’ajout asynchrone. Le résultat de la tâche contient le EntityEntry<TEntity> pour l’entité . L’entrée fournit l’accès aux informations et opérations de suivi des modifications pour l’entité.
Exceptions
Si le CancellationToken est annulé.
Remarques
Cette méthode est asynchrone uniquement pour permettre aux générateurs de valeurs spéciaux, tels que celui utilisé par « Microsoft.EntityFrameworkCore.Metadata.SqlServerValueGenerationStrategy.SequenceHiLo », d’accéder à la base de données de manière asynchrone. Dans tous les autres cas, la méthode non asynchrone doit être utilisée.
Utilisez State pour définir l’état d’une seule entité.
Pour plus d’informations et d’exemples, consultez Suivi des modifications EF Core .
