Método Update (ADO)
Se aplica a: Access 2013, Office 2013
Guarda los cambios realizados en la fila actual de un objeto Recordset o la colección Fields de un objeto Record.
Sintaxis
conjunto de registros. Actualizarcampos, valores
registro. Campos. Actualizar
Parámetros
| Parámetro | Descripción |
|---|---|
| Fields | Es opcional. Variant que representa un solo nombre, o bien, matriz de tipo Variant que representa los nombres o las posiciones ordinales del campo o de los campos que se van a modificar. |
| Values | Es opcional. Variant que representa un solo valor, o bien, matriz de tipo Variant que representa los valores del campo o de los campos en el registro nuevo. |
Comentarios
Recordset
Use el método Update para guardar los cambios efectuados en el registro actual de un objeto Recordset desde la llamada al método AddNew o desde el cambio de alguno de los valores de campo de un registro existente. El objeto Recordset debe ser compatible con las actualizaciones.
Para establecer los valores de campo, siga uno de estos procedimientos:
Asigne valores a la propiedad Value de un objeto Field y llame al método Update.
Pase un nombre de campo y un valor como argumentos con la llamada a Update.
Pase una matriz de nombres de campo y una matriz de valores con la llamada a Update.
Cuando utiliza matrices de campos y valores, debe haber el mismo número de elementos en ambas matrices. Además, el orden de los nombres de campo debe coincidir con el orden de los valores de campo. Si no coinciden el número ni el orden de los campos y valores, se produce un error.
Si el objeto Recordset admite la actualización por lotes, se pueden almacenar en la memoria caché local varios cambios realizados en uno o varios registros hasta que se llama al método UpdateBatch. Si está modificando el registro actual o agregando un nuevo registro mientras llama al método UpdateBatch, ADO llamará automáticamente al método Update para guardar todos los cambios pendientes en el registro actual antes de transmitir al proveedor los cambios por lotes.
Si sale del registro que está agregando o editando antes de llamar al método Update, ADO llamará automáticamente al método Update para guardar los cambios. Debe llamar al método CancelUpdate si desea cancelar los cambios realizados en el registro actual o descartar un registro que acaba de agregar.
El registro actual se mantiene actual después de llamar al método Update.
Record
El método Update finaliza las adiciones, eliminaciones y actualizaciones realizadas en los campos de la colección Fields de un objeto Record.
Por ejemplo, los campos eliminados con el método Delete quedan inmediatamente marcados para su eliminación pero permanecen en la colección. Es preciso llamar al método Update para eliminar realmente estos campos de la colección del proveedor.