DbContext.AddAsync 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.
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)
- Source:
- DbContext.cs
- Source:
- DbContext.cs
- Source:
- DbContext.cs
- Source:
- DbContext.cs
- Source:
- DbContext.cs
- Source:
- DbContext.cs
- Source:
- DbContext.cs
- Source:
- DbContext.cs
- Source:
- DbContext.cs
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> 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)Paramètres
- entity
- Object
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 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
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 .
S’applique à
AddAsync<TEntity>(TEntity, CancellationToken)
- Source:
- DbContext.cs
- Source:
- DbContext.cs
- Source:
- DbContext.cs
- Source:
- DbContext.cs
- Source:
- DbContext.cs
- Source:
- DbContext.cs
- Source:
- DbContext.cs
- Source:
- DbContext.cs
- Source:
- DbContext.cs
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> (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))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
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.
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 .
