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 对象参考