Méthode UpdateBatch (ADO)
S’applique à : Access 2013, Office 2013
Écrit toutes les mises à jour par lot en attente sur le disque.
Syntaxe
recordset. UpdateBatchAffectRecords
Paramètres
| Paramètre | Description |
|---|---|
| AffectRecords | Facultatif. Valeur AffectEnum indiquant le nombre d’enregistrements affectés par la méthode UpdateBatch. |
Remarques
Utilisez la méthode UpdateBatch lorsque vous modifiez un objet Recordset en mode de mise à jour par lot pour transmettre toutes les modifications apportées à un objet Recordset dans la base de données sous-jacente.
Si l'objet Recordset prend en charge la mise à jour par lot, vous pouvez mettre localement en cache plusieurs modifications apportées à un ou plusieurs enregistrements, jusqu'à ce que vous appeliez la méthode UpdateBatch. Si vous modifiez l'enregistrement actif ou si vous ajoutez un nouvel enregistrement lorsque vous appelez la méthode UpdateBatch, ADO appelle automatiquement la méthode Update pour enregistrer les modifications en attente apportées à l'enregistrement actif avant de transmettre les modifications par lot au fournisseur. Vous ne devez utiliser la mise à jour par lot qu'avec un curseur statique ou jeu de clés.
Remarque
[!REMARQUE] Si vous spécifiez adAffectGroup comme valeur de ce paramètre, une erreur est générée lorsqu'il n'y a pas d'enregistrement visible dans l'objet Recordset actif (par exemple, un filtre qui ne donne aucun enregistrement correspondant).
Si la transmission des modifications échoue pour un ou tous les enregistrements en raison d'un conflit avec les données sous-jacentes (par exemple, un enregistrement déjà supprimé par un autre utilisateur), le fournisseur renvoie des avertissements dans la collection Errors et une erreur d'exécution est générée. Utilisez les propriétés Filter (adFilterAffectedRecords) et Status pour rechercher les enregistrements à l’origine de conflits.
Pour annuler les mises à jour par lot en attente, utilisez la méthode CancelBatch.
Si les propriétés dynamiques Unique Table et Update Resync sont définies et que l'objet Recordset est le résultat de l'exécution d'une opération JOIN sur plusieurs tables, l'exécution de la méthode UpdateBatch est implicitement suivie par la méthode Resync en fonction des paramètres définis dans la propriété Update Resync.
L'ordre dans lequel les mises à jour individuelles d'un lot sont effectuées sur la source de données ne correspond pas forcément à celui de leur exécution dans l'objet Recordset local. L'ordre de mises à jour dépend du fournisseur. Ne l'oubliez pas lorsque vous codez des mises à jour associées entre elles, comme des contraintes de clé externe en cas d'insertion ou de mise à jour.