<Completa Recordset Object Reference
O Evento WillChangeRecord
O evento WillChangeRecord é acionado antes de uma ou mais alterações de registro.
Note: antes deste evento retornos, defina o parâmetro de status para adStatusCancel para cancelar a operação que causou este evento ou configurá-lo para adStatusUnwantedEvent para evitar notications subseqüentes.
O Evento RecordChangeComplete
O evento RecordChangeComplete é acionado depois que um ou mais registro foram alterados.
Note: Antes de esse método retorna, definir o parâmetro de status para adStatusUnwantedEvent para evitar notificações subseqüentes.
Note: O evento WillChangeRecord ou o evento RecordChangeComplete pode ocorrer se você alterar um campo em um registro utilizando uma das seguintes operações de registros: Update, Delete, CancelUpdate, AddNew, UpdateBatch e CancelBatch.
Sintaxe
WillChangeRecord reason,numrec,status,objRs
RecordChangeComplete reason,numrec,objErr,status,objRs
| Parâmetro | Descrição |
|---|---|
| reason | Um EventReasonEnum valor que especifica a razão para este evento |
| numrec | Indica o número de registros afetados |
| status | Um EventStatusEnum valor que indica o status da execução do evento |
| objErr | O nome de um objeto de erro que descreve o erro se status é definido como adStatusErrorsOccurred, caso contrário ele não está definida |
| objRs | O nome do objeto Recordset que desencadeou este evento |
Valores EventReasonEnum
| Constante | Valor | Descrição |
|---|---|---|
| adRsnAddNew | 1 | Uma operação adicionou um novo recorde |
| adRsnDelete | 2 | Uma operação apagado um registro |
| adRsnUpdate | 3 | Uma operação atualizou um registro existente |
| adRsnUndoUpdate | 4 | Uma operação revertida a atualização de um registro |
| adRsnUndoAddNew | 5 | Uma operação reverteu a adição de um novo recorde |
| adRsnUndoDelete | 6 | Uma operação reverteu a exclusão de um registro |
| adRsnFirstChange | 11 | Uma operação feita a primeira mudança para um recorde |
Valores EventStatusEnum
| Constante | Valor | Descrição |
|---|---|---|
| adStatusOK | 1 | A operação que causou o evento foi bem sucedido |
| adStatusErrorsOccurred | 2 | A operação que causou o evento falhou |
| adStatusCantDeny | 3 | A operação que causou o evento não pode ser cancelado |
| adStatusCancel | 4 | A operação que causou o evento é cancelado |
| adStatusUnwantedEvent | 5 | Impede notificações subseqüentes antes que o método evento acabou executando |
<Completa Recordset Object Reference