Compartilhar via

Eventos WillChangeField e FieldChangeComplete (ADO)

  • Artigo

O evento WillChangeField é chamado antes que uma operação pendente altere o valor de um ou mais objetos Field no Recordset. 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 Fields.

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

pError
Um objeto Error. Ele descreve o erro ocorrido se o valor de adStatus é adStatusErrorsOccurred, caso contrário, ele não é 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 como adStatusErrorsOccurred se houve uma falha na operação.

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

Antes que FieldChangeComplete seja retornado, defina esse parâmetro como adStatusUnwantedEvent para evitar as notificações seguintes.

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

Comentários

Um evento WillChangeField ou FieldChangeComplete pode ocorrer na definição da propriedade Value e do chamamento do método Update com parâmetros de matriz de campo e valor.

Consulte Também

Exemplo do modelo de eventos ADO (VC++)
Resumo do manipulador de eventos ADO