Eventos ADO WillChangeRecordset e RecordsetChangeComplete
❮ Referência Completa do Objeto do Conjunto de Registros
O evento WillChangeRecordset
O evento WillChangeRecordset é acionado antes de uma operação alterar o Recordset.
Observação: antes que esse evento retorne, defina o parâmetro status como adStatusCancel para cancelar a operação que causou esse evento ou defina-o como adStatusUnwantedEvent para evitar notificações subsequentes.
O evento RecordsetChangeComplete
O evento RecordsetChangeComplete é acionado após a alteração de um Recordset.
Observação: antes que esse evento retorne, defina o parâmetro status como adStatusUnwantedEvent para evitar notificações subsequentes.
Observação: Os eventos WillChangeRecordset e RecordsetChangeComplete podem ocorrer ao chamar o método Requery ou o método Open de um objeto Recordset.
Sintaxe
WillChangeRecord reason,status,objRs
RecordsetChangeComplete reason,objErr,status,objRs
| Parameter | Description |
|---|---|
| reason | An EventReasonEnum value that specifies the reason for this event |
| 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 EventReasonEnum
| Constant | Value | Description |
|---|---|---|
| adRsnRequery | 7 | An operation requeried the Recordset |
| adRsnResynch | 8 | An operation resynchronized the Recordset with the database |
| adRsnClose | 9 | An operation closed the Recordset |
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