ADO Los eventos WillChangeRecord y RecordChangeComplete
❮ Referencia completa de objetos de conjunto de registros
El evento WillChangeRecord
El evento WillChangeRecord se desencadena antes de uno o más cambios de registro.
Nota: Antes de que vuelva este evento, establezca el parámetro de estado en adStatusCancel para cancelar la operación que provocó este evento o configúrelo en adStatusUnwantedEvent para evitar notificaciones posteriores.
El evento RecordChangeComplete
El evento RecordChangeComplete se activa después de que se hayan cambiado uno o más registros.
Nota: antes de que este método regrese, establezca el parámetro de estado en adStatusUnwantedEvent para evitar notificaciones posteriores.
Nota: El evento WillChangeRecord o RecordChangeComplete puede ocurrir si cambia un campo en un registro mediante una de las siguientes operaciones de Recordset: Actualizar, Eliminar, Cancelar actualización, Agregar nuevo, Actualizar lote y Cancelar lote.
Sintaxis
WillChangeRecord reason,numrec,status,objRs
RecordChangeComplete reason,numrec,objErr,status,objRs
Parameter | Description |
---|---|
reason | An EventReasonEnum value that specifies the reason for this event |
numrec | Indicates the number of records affected |
status | An EventStatusEnum value that indicates the status of the execution of the event |
objErr | The name of an Error object that describes the error if status is set to adStatusErrorsOccurred, otherwise it is not set |
objRs | The name of the Recordset Object that triggered this event |
Valores de EventReasonEnum
Constant | Value | Description |
---|---|---|
adRsnAddNew | 1 | An operation added a new record |
adRsnDelete | 2 | An operation deleted a record |
adRsnUpdate | 3 | An operation updated an existing record |
adRsnUndoUpdate | 4 | An operation reversed the update of a record |
adRsnUndoAddNew | 5 | An operation reversed the addition of a new record |
adRsnUndoDelete | 6 | An operation reversed the deletion of a record |
adRsnFirstChange | 11 | An operation made the first change to a record |
Valores de EventStatusEnum
Constant | Value | Description |
---|---|---|
adStatusOK | 1 | The operation that caused the event was successful |
adStatusErrorsOccurred | 2 | The operation that caused the event failed |
adStatusCantDeny | 3 | The operation that caused the event cannot be cancelled |
adStatusCancel | 4 | The operation that caused the event is cancelled |
adStatusUnwantedEvent | 5 | Prevents subsequent notifications before the event method has finished executing |
❮ Referencia completa de objetos de conjunto de registros