Eventos WillChangeRecord y RecordChangeComplete (ADO)

Se llama al evento WillChangeRecord antes de uno o varios registros (filas) en el cambio del objeto Recordset . Se llama al evento RecordChangeComplete después de cambiar uno o varios registros.

Sintaxis

  
WillChangeRecord adReason, cRecords, adStatus, pRecordset  
RecordChangeCompletedReason, cRecords, pError, adStatus, pRecordset  

Parámetros

adReason
Valor EventReasonEnum que especifica el motivo de este evento. Su valor puede ser adRsnAddNew, adRsnDelete, adRsnUpdate, adRsnUndoUpdate, adRsnUndoAddNew, adRsnUndoDelete o adRsnFirstChange.

cRecords
Valor long que indica el número de registros que cambian (afectados).

pError
Objeto Error de. Describe el error que se produjo si el valor de adStatus es adStatusErrorsOccurred; de lo contrario, no se establece.

adStatus
Valor de estado EventStatusEnum.

Cuando se llama a WillChangeRecord , este parámetro se establece en adStatusOK si la operación que provocó el evento se realizó correctamente. Se establece en adStatusCantDeny si este evento no puede solicitar la cancelación de la operación pendiente.

Cuando se llama a RecordChangeComplete , este parámetro se establece en adStatusOK si la operación que provocó el evento se realizó correctamente o en adStatusErrorsOccurred si se produjo un error en la operación.

Antes de que Se devuelva WillChangeRecord , establezca este parámetro en adStatusCancel para solicitar la cancelación de la operación que provocó este evento o establezca este parámetro en adStatusUnwantedEvent para evitar notificaciones posteriores.

Antes de que se devuelva RecordChangeComplete , establezca este parámetro en adStatusUnwantedEvent para evitar notificaciones posteriores.

pRecordset
Objeto Recordset. El Recordset para el que se produjo este evento.

Observaciones

Puede producirse un evento WillChangeRecord o RecordChangeComplete para el primer campo cambiado de una fila debido a las siguientes operaciones del objeto Recordset : Update, Delete, CancelUpdate, AddNew, UpdateBatch y CancelBatch. El valor de RecordsetCursorType determina qué operaciones hacen que se produzcan los eventos.

Durante el evento WillChangeRecord, la propiedad Filter del objeto Recordset se establece en adFilterAffectedRecords. No puede cambiar esta propiedad mientras procesa el evento.

Debe establecer el parámetro adStatus en adStatusUnwantedEvent para cada valor adReason posible para detener completamente la notificación de eventos para cualquier evento que incluya un parámetro adReason .

Véase también

Ejemplo del modelo de eventos de ADO de (VC++)
Resumen del controlador de eventos de ADO