Update (método)

  • Artículo

Guarda los cambios que realice en la fila actual de un objeto Recordset o en la colección Fields de un objeto Record.

Sintaxis

  
recordset.Update Fields, Values  
record.Fields.Update

Parámetros

Fields
Opcional. Variante Variant que representa un nombre único, o una matriz Variant que representa nombres o posiciones ordinales del campo o campos que desea modificar.

Valores
Opcional. Una variante Variant que representa un valor único, o una matriz Variant que representa valores para el campo o los campos del nuevo registro.

Comentarios

Recordset

Use el método Update para guardar los cambios realizados en el registro actual de un objeto Recordset desde que llama al método AddNew o desde que cambia los valores de campo de un registro existente. El objeto Recordset debe admitir actualizaciones.

Para establecer valores de campo, realice una de las siguientes acciones:

  • 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 Update.

Cuando se usan matrices de campos y valores, debe haber un número igual de elementos en ambas. Además, el orden de los nombres de campo debe coincidir con el orden de los valores de campo. Si el número y el orden de los campos y valores no coinciden, se producirá un error.

Si el objeto Recordset admite la actualización por lotes, puede almacenar en caché varios cambios en uno o varios registros localmente hasta que llame al método UpdateBatch. Si está editando el registro actual o agregando un nuevo registro al llamar al método UpdateBatch, ADO llamará automáticamente al método Update para guardar los cambios pendientes en el registro actual antes de transmitir los cambios por lotes al proveedor.

Si se mueve del registro que va a agregar o editar 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 recién agregado.

El registro actual permanece como principal después de llamar al método Update.

Registro

El método Update finaliza las adiciones, eliminaciones y actualizaciones de los campos de la colección Fields de un objeto Record.

Por ejemplo, los campos eliminados con el método Delete se marcan para su eliminación inmediatamente, pero permanecen en la colección. Se debe llamar al método Update para eliminar estos campos de la colección del proveedor.

Se aplica a

Fields (colección) (ADO)

Objeto de conjunto de registros (ADO)

Consulte también

Ejemplo de los métodos Update y CancelUpdate (VB)
Ejemplo de los métodos Update y CancelUpdate (VC ++)
AddNew (método) (ADO)
Método CancelUpdate (ADO)
Propiedad EditMode
Método UpdateBatch