DbSet<TEntity>.AddAsync(TEntity, CancellationToken) Méthode

Définition

Espace de noms:

Microsoft.EntityFrameworkCore

Assembly:

Microsoft.EntityFrameworkCore.dll

Paquet:

Microsoft.EntityFrameworkCore v8.0.0

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

Paramètres

entity

TEntity

Entité à ajouter.

cancellationToken

CancellationToken

CancellationToken À observer en attendant la fin de la tâche.

Retours

ValueTask<EntityEntry<TEntity>>

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

OperationCanceledException

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 .