Update, méthode

  • Article

Enregistre les modifications apportées à la ligne actuelle d’un objet Recordset ou à la collection Champ d’un objet Record .

Syntaxe

  
recordset.Update Fields, Values  
record.Fields.Update

Paramètres

Fields
facultatif. Variant qui représente un nom unique ou un tableau Variant qui représente des noms ou des positions ordinales du champ ou des champs que vous souhaitez modifier.

Valeurs
facultatif. Variant qui représente une valeur unique ou un tableau Variant qui représente des valeurs pour le champ ou les champs du nouvel enregistrement.

Notes

Ensemble d'enregistrements

Utilisez la méthode Update pour enregistrer les modifications que vous avez apportées à l’enregistrement actif d’un objet Recordset depuis l’appel de la méthode AddNew ou la modification des valeurs de champ dans un enregistrement existant. L’objet Recordset doit prendre en charge les mises à jour.

Pour définir des valeurs de champ, effectuez l’une des opérations suivantes :

  • Affectez des valeurs à la propriété Valeur d’un objet Champ et appelez la méthode Update.

  • Passez un nom de champ et une valeur en tant qu’arguments avec l’appel Update .

  • Passez un tableau de noms de champs et un tableau de valeurs avec l’appel Update .

Lorsque vous utilisez des tableaux de champs et de valeurs, il doit y avoir un nombre égal d’éléments dans les deux tableaux. En outre, l'ordre des noms de champ doit correspondre à l'ordre des valeurs de champ. Si le nombre et l’ordre des champs et des valeurs ne correspondent pas, une erreur se produit.

Si l’objet Recordset prend en charge la mise à jour par lots, vous pouvez mettre en cache plusieurs modifications apportées à un ou plusieurs enregistrements localement jusqu’à appeler 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 dans l’enregistrement actif avant de transmettre les modifications par lot au fournisseur.

Si vous passez de l’enregistrement que vous ajoutez ou modifiez avant d’appeler la méthode Update , ADO appelle automatiquement Update pour enregistrer les modifications. Vous devez appeler la méthode CancelUpdate si vous souhaitez annuler les modifications apportées à l’enregistrement actif ou ignorer un enregistrement nouvellement ajouté.

L'enregistrement actuel reste à jour après que vous ayez appelé la méthode Update.

Enregistrement

La méthode Update finalise les ajouts, les suppressions et les mises à jour des champs dans la collection Champ d’un objet Enregistrement .

Par exemple, les champs supprimés avec la méthode Supprimer sont marqués immédiatement pour la suppression, mais restent dans la collection. La méthode Update doit être appelée pour supprimer ces champs de la collection du fournisseur.

S'applique à

Fields, collection (ADO)

Recordset, objet (ADO)

Voir aussi

Update et CancelUpdate, exemple de méthodes (VB)
Update et CancelUpdate, exemple de méthodes (VC++)
AddNew, méthode (ADO)
CancelUpdate, méthode (ADO)
EditMode, propriété
UpdateBatch, méthode