Eventos ADO WillChangeField e FieldChangeComplete
❮ Referência Completa do Objeto do Conjunto de Registros
O evento WillChangeField
O evento WillChangeField é acionado antes que os valores de um ou mais Field Objects sejam alterados.
Observação: antes que esse evento retorne, defina o parâmetro status como adStatusCancel para cancelar a operação que causou esse evento.
O evento FieldChangeComplete
O evento FieldChangeComplete é acionado após a alteração dos valores de um ou mais objetos de campo.
Observação: antes que esse evento retorne, defina o parâmetro status como adStatusUnwantedEvent para evitar notificações subsequentes.
Observação: o evento WillChangeField e o evento FieldChangeComplete podem ocorrer quando você define a propriedade Value e chama o método Update com parâmetros de campo e matriz de valor.
Sintaxe
WillChangeField numfields,fields,status,objRs
FieldChangeComplete numfields,fields,objErr,status,objRs
Parameter | Description |
---|---|
numfields | The number of Field objects in fields |
fields | An array that contains Field objects with changes |
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 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 |
❮ Referência Completa do Objeto do Conjunto de Registros