Partager via


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

Définition

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

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

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 .

S’applique à