DbContext.SaveChangesAsync 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
SaveChangesAsync() |
Enregistre de manière asynchrone toutes les modifications apportées dans ce contexte dans la base de données sous-jacente. |
SaveChangesAsync(CancellationToken) |
Enregistre de manière asynchrone toutes les modifications apportées dans ce contexte dans la base de données sous-jacente. |
SaveChangesAsync()
Enregistre de manière asynchrone toutes les modifications apportées dans ce contexte dans la base de données sous-jacente.
public virtual System.Threading.Tasks.Task<int> SaveChangesAsync ();
abstract member SaveChangesAsync : unit -> System.Threading.Tasks.Task<int>
override this.SaveChangesAsync : unit -> System.Threading.Tasks.Task<int>
Public Overridable Function SaveChangesAsync () As Task(Of Integer)
Retours
Tâche qui représente l’opération d’écriture d’enregistrement asynchrone. Le résultat de la tâche contient le nombre d’entrées d’état écrites dans la base de données sous-jacente. Cela peut inclure des entrées d’état pour les entités et/ou les relations. Les entrées d’état de relation sont créées pour les relations plusieurs-à-plusieurs et les relations où aucune propriété de clé étrangère n’est incluse dans la classe d’entité (souvent appelées associations indépendantes).
Exceptions
Une erreur s’est produite lors de l’envoi de mises à jour à la base de données.
Une commande de base de données n’a pas affecté le nombre attendu de lignes. Cela indique généralement une violation d’accès concurrentiel optimiste ; autrement dit, une ligne a été modifiée dans la base de données depuis qu’elle a été interrogée.
L’enregistrement a été abandonné, car la validation des valeurs de propriété d’entité a échoué.
Une tentative a été effectuée pour utiliser un comportement non pris en charge, tel que l’exécution simultanée de plusieurs commandes asynchrones sur le même contexte instance.
Le contexte ou la connexion ont été supprimés.
Une erreur s’est produite lors de la tentative de traitement des entités dans le contexte avant ou après l’envoi de commandes à la base de données.
Remarques
Plusieurs opérations actives sur le même contexte instance ne sont pas prises en charge. Utilisez « await » pour vous assurer que toutes les opérations asynchrones sont terminées avant d’appeler une autre méthode sur ce contexte.
S’applique à
SaveChangesAsync(CancellationToken)
Enregistre de manière asynchrone toutes les modifications apportées dans ce contexte dans la base de données sous-jacente.
[System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Usage", "CA1801:ReviewUnusedParameters", MessageId="cancellationToken")]
public virtual System.Threading.Tasks.Task<int> SaveChangesAsync (System.Threading.CancellationToken cancellationToken);
abstract member SaveChangesAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<int>
override this.SaveChangesAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<int>
Paramètres
- cancellationToken
- CancellationToken
CancellationToken à observer en attendant la fin de la tâche.
Retours
Tâche qui représente l’opération d’écriture d’enregistrement asynchrone. Le résultat de la tâche contient le nombre d’entrées d’état écrites dans la base de données sous-jacente. Cela peut inclure des entrées d’état pour les entités et/ou les relations. Les entrées d’état de relation sont créées pour les relations plusieurs-à-plusieurs et les relations où aucune propriété de clé étrangère n’est incluse dans la classe d’entité (souvent appelées associations indépendantes).
- Attributs
Exceptions
Levée si le contexte a été supprimé.
Remarques
Plusieurs opérations actives sur le même contexte instance ne sont pas prises en charge. Utilisez « await » pour vous assurer que toutes les opérations asynchrones sont terminées avant d’appeler une autre méthode sur ce contexte.