Eventos WillChangeField e FieldChangeComplete (ADO)

O evento WillChangeField é chamado antes que uma operação pendente altere o valor de um ou mais objetos de Campo no do Conjunto de Registros. O evento FieldChangeComplete é chamado depois que o valor de um ou mais objetos Field foi alterado.

Sintaxe

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

Parâmetros

cFields
Um Long que indica o número de objetos Field em campos .

campos
Para WillChangeField, o parâmetro Fields é uma matriz de Variants que contém objetos Field com os valores originais. Para FieldChangeComplete, o parâmetro campos é uma matriz de variants que contém objetos Field com os valores alterados.

pError
Um objeto Error. Ele descreve o erro que ocorreu se o valor de adStatus for adStatusErrorsOccurred; caso contrário, não está definido.

adStatus
Um valor de status EventStatusEnum.

Quando willChangeField é chamado, esse parâmetro é definido como adStatusOK se a operação que causou o evento foi bem-sucedida. Ele será definido como adStatusCantDeny se esse evento não puder solicitar o cancelamento da operação pendente.

Quando FieldChangeComplete é chamado, esse parâmetro é definido como adStatusOK se a operação que causou o evento foi bem-sucedida ou para adStatusErrorsOccurred se a operação falhou.

Antes que WillChangeField retorne, defina esse parâmetro como adStatusCancel para solicitar o cancelamento da operação pendente.

Antes de FieldChangeComplete retornar, defina esse parâmetro como adStatusUnwantedEvent para evitar notificações subsequentes.

pRecordset
Um objeto Recordset. O conjunto de registros para o qual esse evento ocorreu.

Observações

Um evento WillChangeField ou FieldChangeComplete pode ocorrer ao definir a propriedade Value e chamar o método Update com parâmetros de matriz de valor e campo.

Consulte Também

exemplo de modelo de eventos do ADO (VC++)
resumo do manipulador de eventos do ADO