Update, méthode (ADO)
S’applique à : Access 2013, Office 2013
Enregistre les modifications apportées à la ligne active d’un objet Recordset ou à la collection Fields d’un objet Record.
Syntaxe
recordset. Mettre à jourles champs, les valeurs
enregistrement. Champs. Mettre à jour
Paramètres
| Paramètre | Description |
|---|---|
| Fields | Facultatif. Valeur de type Variant représentant un nom unique ou tableau de valeurs Variant représentant les noms ou positions ordinales des champs à modifier. |
| Values | Facultatif. Valeur de type Variant représentant une valeur unique ou un tableau de valeurs Variant représentant les valeurs du ou des champs du nouvel enregistrement. |
Remarques
Recordset
Utilisez la méthode Update pour enregistrer les modifications apportées à l'enregistrement actif d'un objet Recordset depuis l'appel de la méthode AddNew ou la modification des valeurs des champs d'un enregistrement existant. L'objet Recordset doit prendre en charge les mises à jour.
Pour définir des valeurs de champ, effectuez l'une des actions suivantes :
Affectez des valeurs à la propriété Value d'un objet Field et appelez la méthode Update.
Passez un nom de champ et une valeur comme arguments avec l'appel de Update.
Passez un tableau de noms de champs et un tableau de valeurs avec l'appel de Update.
Lorsque vous utilisez des tableaux de champs et de valeurs, ces deux tableaux doivent contenir le même nombre d'éléments. De même, l'ordre des noms de champs doit correspondre à l'ordre des valeurs des champs. Si le nombre et l'ordre des champs et des valeurs ne correspondent pas, une erreur est générée.
Si l'objet Recordset prend en charge la mise à jour par lot, vous pouvez mettre en cache plusieurs modifications d'un ou plusieurs enregistrements jusqu'à ce que vous appeliez la méthode UpdateBatch. Si vous modifiez l'enregistrement actif ou que 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 avant de transmettre les modifications mises en cache au fournisseur.
Si vous quittez l'enregistrement ajouté ou modifié avant d'appeler la méthode Update, ADO appelle automatiquement la méthode Update pour enregistrer les modifications. Vous devez appeler la méthode CancelUpdate si vous souhaitez annuler les modifications apportées à l'enregistrement actif ou supprimer un enregistrement qui vient d'être ajouté.
L'enregistrement actif reste actif après avoir appelé la méthode Update.
Enregistrement
La méthode Update finalise les ajouts, suppressions et mises à jour des champs de la collection Fields d'un objet Record.
Par exemple, les champs supprimés avec la méthode Delete sont marqués immédiatement pour suppression mais restent dans la collection. La méthode Update doit être appelée pour supprimer réellement ces champs de la collection du fournisseur.