DbContext.AddAsync Méthode

Définition

Espace de noms:

Microsoft.EntityFrameworkCore

Assembly:

Microsoft.EntityFrameworkCore.dll

Paquet:

Microsoft.EntityFrameworkCore v8.0.0

Surcharges

AddAsync(Object, CancellationToken)	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.
AddAsync<TEntity>(TEntity, CancellationToken)	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.

AddAsync(Object, CancellationToken)

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> AddAsync (object entity, System.Threading.CancellationToken cancellationToken = default);

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 ValueTask(Of EntityEntry)

Paramètres

entity

Object

Entité à ajouter.

cancellationToken

CancellationToken

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

Retours

ValueTask<EntityEntry>

Tâche qui représente l’opération d’ajout asynchrone. Le résultat de la tâche contient le EntityEntry 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

Utilisez State pour définir l’état d’une seule entité.

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.

Entity Framework Core ne prend pas en charge plusieurs opérations parallèles exécutées sur le même instance DbContext. Cela inclut l’exécution parallèle de requêtes asynchrones et toute utilisation simultanée explicite de plusieurs threads. Par conséquent, attendez toujours immédiatement les appels asynchrones ou utilisez des instances DbContext distinctes pour les opérations qui s’exécutent en parallèle. Pour plus d’informations et d’exemples, consultez Éviter les problèmes de thread dbContext .

Pour plus d’informations et d’exemples, consultez Suivi des modifications EF Core .

AddAsync<TEntity>(TEntity, CancellationToken)

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> (TEntity entity, System.Threading.CancellationToken cancellationToken = default) where TEntity : class;

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 ValueTask(Of EntityEntry(Of TEntity))

Paramètres de type

TEntity

Le type de l’entité.

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.

Entity Framework Core ne prend pas en charge plusieurs opérations parallèles exécutées sur le même instance DbContext. Cela inclut l’exécution parallèle de requêtes asynchrones et toute utilisation simultanée explicite de plusieurs threads. Par conséquent, attendez toujours immédiatement les appels asynchrones ou utilisez des instances DbContext distinctes pour les opérations qui s’exécutent en parallèle. Pour plus d’informations et d’exemples, consultez Éviter les problèmes de thread dbContext .

Pour plus d’informations et d’exemples, consultez Suivi des modifications EF Core .