ADO WillChangeRecordset 和 RecordsetChangeComplete 事件
❮ 完整的 Recordset 对象参考
WillChangeRecordset 事件
WillChangeRecordset 事件在 Recordset 被操作更改之前触发。
注意:在此事件返回之前,将 status 参数设置为 adStatusCancel 可取消导致此事件的操作,或设置为 adStatusUnwantedEvent 可阻止后续通知。
RecordsetChangeComplete 事件
RecordsetChangeComplete 事件在 Recordset 更改之后触发。
注意:在此事件返回之前,将 status 参数设置为 adStatusUnwantedEvent 可阻止后续通知。
注意:调用 Recordset 对象的 Requery 方法或 Open 方法时,可能会发生 WillChangeRecordset 和 RecordsetChangeComplete 事件。
语法
WillChangeRecord reason,status,objRs
RecordsetChangeComplete reason,objErr,status,objRs
| 参数 | 描述 |
|---|---|
| reason | 一个 EventReasonEnum 值,指定此事件的原因 |
| status | 一个 EventStatusEnum 值,指示事件执行的状态 |
| objErr | 如果 status 设置为 adStatusErrorsOccurred,则描述错误的 Error 对象的名称,否则未设置 |
| objRs | 触发此事件的 Recordset 对象的名称 |
EventReasonEnum 值
| 常量 | 值 | 描述 |
|---|---|---|
| adRsnRequery | 7 | 操作重新查询了 Recordset |
| adRsnResynch | 8 | 操作将 Recordset 与数据库重新同步 |
| adRsnClose | 9 | 操作关闭了 Recordset |
EventStatusEnum 值
| 常量 | 值 | 描述 |
|---|---|---|
| adStatusOK | 1 | 导致事件的操作成功 |
| adStatusErrorsOccurred | 2 | 导致事件的操作失败 |
| adStatusCantDeny | 3 | 导致事件的操作无法取消 |
| adStatusCancel | 4 | 导致事件的操作已取消 |
| adStatusUnwantedEvent | 5 | 在事件方法执行完成之前阻止后续通知 |
❮ 完整的 Recordset 对象参考