Método CancelUpdate (ADO)

Se aplica a: Access 2013, Office 2013

Cancela los cambios realizados en la fila activa o fila nueva de un objeto Recordset, o bien, la colección Fields de un objeto Record, antes de llamar al método Update.

Sintaxis

conjunto de registros. Cancelupdate

registro. Campos. Cancelupdate

Comentarios

Recordset

Utilice el método CancelUpdate para cancelar los cambios realizados en la fila actual o descartar una fila recién agregada. No puede cancelar los cambios realizados en la fila actual o una fila nueva después de llamar al método Update, a menos que los cambios formen parte de una transacción que puede deshacer con el método RollbackTrans, o bien, formen parte de una actualización por lotes. En este último caso, puede cancelar el método Update con el método CancelUpdate o CancelBatch.

Si está agregando una fila nueva al llamar al método CancelUpdate, la actual fila pasa a ser la fila que era actual antes de la llamada a AddNew.

Si está en modo de edición y desea salir del registro actual (por ejemplo, con Move, NextRecordset o Close), puede usar CancelUpdate para cancelar los cambios pendientes. Quizás tenga que hacer esto si la actualización no se puede enviar correctamente al origen de datos (por ejemplo, un intento de eliminación que genera un error debido a infracciones de la integridad referencial dejará el objeto Recordset en modo de edición después de una llamada a Delete).

Record

El método CancelUpdate cancela todas las inserciones o eliminaciones pendientes de los objetos Field, además de cancelar las actualizaciones pendientes de los campos existentes y restaurar sus valores originales. La propiedad Status de todos los campos de la colección Fields se establece en adFieldOK.