Compartir a través de

Eventos WillChangeField y FieldChangeComplete (ADO)

  • Artículo

Se llama al evento WillChangeField antes de que una operación pendiente cambie el valor de uno o varios objetos Field del Recordset. Se llama al evento FieldChangeComplete después de cambiar el valor de uno o varios objetos Field.

Sintaxis

  
WillChangeField cFields, Fields, adStatus, pRecordset  
FieldChangeComplete cFields, Fields, pError, adStatus, pRecordset

Parámetros

cFields
Long que indica el número de objetos Field en Fields.

Fields
Para WillChangeField, el parámetro Fields es una matriz de Variants que contiene objetos Field con los valores originales. Para FieldChangeComplete, el parámetro Fields es una matriz de Variants que contiene objetos Field con los valores modificados.

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

adStatus
Valor de estado EventStatusEnum.

Cuando se llama a WillChangeField, 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 FieldChangeComplete, 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 WillChangeField devuelva, establezca este parámetro en adStatusCancel para solicitar la cancelación de la operación pendiente.

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

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

Comentarios

Puede producirse un evento WillChangeField o FieldChangeComplete al establecer la propiedad Value y llamar al método Update con parámetros de matriz de campo y valor.

Consulte también

Ejemplo de modelo de eventos de ADO (VC ++)
Conexión ADO y los eventos de conjunto de registros