Update, méthode
Enregistre les modifications que vous apportez à la ligne actuelle d’un objet Recordset, ou la collection Fields d’un objet Record .
Syntaxe
recordset.Update Fields, Values
record.Fields.Update
Paramètres
champs
Optionnel.
Variant qui représente un nom unique ou un tableau Variant qui représente les noms ou les positions ordinales du champ ou des champs que vous souhaitez modifier.
valeurs
Optionnel.
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.
Remarques
Recordset
Utilisez la méthode Update pour enregistrer les modifications apportées à l’enregistrement actuel 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é Value d’un objet Field field et appelez la méthode Update.
Passez un nom de champ et une valeur en tant qu’arguments avec l’appel Update.
Transmettez 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 champs 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 sur un ou plusieurs enregistrements localement jusqu’à ce que vous appeliez la méthode UpdateBatch. Si vous modifiez l’enregistrement actif ou ajoutez un nouvel enregistrement lorsque vous appelez la méthode UpdateBatch, ADO appelle automatiquement la méthode Update pour enregistrer les modifications en attente de 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 actif reste actif après avoir appelé la méthode Update.
Enregistrer
La méthode update finalise les ajouts, les suppressions et les mises à jour des champs dans la collection Fields d’un objet Record Record.
Par exemple, les champs supprimés avec la méthode Delete sont marqués pour suppression immédiatement, mais restent dans la collection. La méthode Update doit être appelée pour supprimer réellement ces champs de la collection du fournisseur.
S’applique à
Voir aussi
Update et CancelUpdate, méthodes - Exemple (VB)
Update et CancelUpdate, méthodes - Exemple (VC++)
AddNew, méthode (ADO)
CancelUpdate, méthode (ADO)
EditMode, propriété
méthode UpdateBatch