ADO事件之(8)---WillChangeRecord 和 RecordChangeComplete (RecordsetEvent) 方法

ado

WillChangeRecord 和 RecordChangeComplete (RecordsetEvent) 方法

WillChangeRecord 方法在 Recordset 中的一个或多个记录(行)更改之前调用。RecordChangeComplete 方法在一个或多个记录更改之后调用。

语法

WillChangeRecord adReason, cRecords, adStatus, pRecordset

RecordChangeComplete adReason, cRecords, pError, adStatus, pRecordset

参数

adReason EventReasonEnum 值,指定该事件的原因。它的值可以是 adRsnAddNew、adRsnDelete、adRsnUpdate、adRsnUndoUpdate、adRsnUndoAddNew、adRsnUndoDelete 或 adRsnFirstChange。

cRecords 长整型,更改(影响)的记录数目。

pError Error 对象,说明当 adStatus 值为 adStatusErrorsOccurred 时所发生的错误,否则将不对它进行设置。

adStatus EventStatusEnum 状态值。

当调用 WillChangeRecord 时,如果引发事件的操作成功,该参数设置为 adStatusOK。如果该方法无法请求取消挂起的操作,则设置为 adStatusCantDeny。

当调用 RecordChangeComplete 时,如果引发事件的操作成功,则该参数设置为 adStatusOK。如果操作失败,则设置为 adStatusErrorsOccurred。

在 WillChangeRecord 返回前,将该参数设置为 adStatusCancel 可请求取消引发该事件的操作。

在 RecordChangeComplete 返回前,将该参数设置为 adStatusUnwantedEvent 可防止后续的通知。

pRecordset Recordset 对象,发生该事件所针对的 Recordset。

说明

WillChangeRecord 或 RecordChangeComplete 事件可因下列 Recordset 操作并针对行中第一个更改的字段发生:Update、Delete、CancelUpdate、AddNew、UpdateBatch 和 CancelBatch。Recordset CursorType 的值决定了是哪一个操作导致事件发生。

在 WillChangeRecord 事件期间,Recordset Filter 属性设置为 adFilterAffectedRecords。在处理事件时更改该属性是不合法的。

时间: 2024-11-03 10:56:07

ADO事件之(8)---WillChangeRecord 和 RecordChangeComplete (RecordsetEvent) 方法的相关文章

ADO事件之(7)---WillChangeField 和 FieldChangeComplete (RecordsetEvent) 方法

ado WillChangeField 和 FieldChangeComplete (RecordsetEvent) 方法 WillChangeField 方法在挂起操作对 Recordset 中一个或多个 Field 对象的值进行更改前调用.FieldChangeComplete 方法在一个或多个 Field 对象的值已经更改后调用. 语法 WillChangeField cFields, Fields, adStatus, pRecordset FieldChangeComplete cFi

ADO事件之(12)---WillMove and MoveComplete (RecordsetEvent) 方法

ado WillMove and MoveComplete (RecordsetEvent) 方法 WillMove 方法在挂起操作更改 Recordset 中的当前位置前调用.MoveComplete 方法则在 Recordset 的当前位置更改后调用. 语法 WillMove adReason, adStatus, pRecordset MoveComplete adReason, pError, adStatus, pRecordset 参数 adReason EventReasonEnu

ADO事件之(8)---WillChangeRecord 和 RecordChangeComplet

WillChangeRecord 和 RecordChangeComplete (RecordsetEvent) 方法WillChangeRecord 方法在 Recordset 中的一个或多个记录(行)更改之前调用.RecordChangeComplete 方法在一个或多个记录更改之后调用.语法WillChangeRecord adReason, cRecords, adStatus, pRecordsetRecordChangeComplete adReason, cRecords, pEr

ADO事件之(9)---WillChangeRecordset 和 RecordsetChangeComplete (RecordsetEvent) 事件

ado WillChangeRecordset 和 RecordsetChangeComplete (RecordsetEvent) 事件 WillChangeRecordset 方法在挂起操作更改 Recordset 之前调用.RecordsetChangeComplete 方法在 Recordset 更改后调用. 语法 WillChangeRecordset adReason, adStatus, pRecordset RecordsetChangeComplete adReason, pE

ADO事件之(1)---ConnectComplete 和 Disconnect (ConnectionEvent) 方法

ado|connection ConnectComplete 和 Disconnect (ConnectionEvent) 方法 ConnectComplete 方法在连接开始后调用.Disconnect 方法在连接结束后调用. 语法 ConnectComplete pError, adStatus, pConnection Disconnect adStatus, pConnection 参数 pError Error 对象.它表示当 adStatus 的值为 adStatusErrorsOc

ADO事件之(2)---EndOfRecordset (RecordsetEvent) 方法

ado EndOfRecordset (RecordsetEvent) 方法 如果试图移动到超过 Recordset 结尾的行时,将调用 EndOfRecordset 方法. 语法 EndOfRecordset fMoreData, adStatus, pRecordset 参数 fMoreData VARIANT_BOOL,在处理该事件期间有可能将新记录追加到 pRecordset.在 EndOfRecordset 返回前添加数据,然后将该参数设置为 True 以指示 Recordset 的新

ADO事件之(4)---FetchComplete (RecordsetEvent) 方法

ado FetchComplete (RecordsetEvent) 方法 该方法在长异步操作中所有记录已经恢复(获取)到记录集之后调用. 语法 FetchComplete pError, adStatus, pRecordset 语法 pError Error 对象,说明当 adStatus 值为 adStatusErrorsOccurred 时所发生的错误,否则将不对它进行设置. adStatus EventStatusEnum 状态值,当调用该方法时,如果引发事件的操作成功,则参数设置为

ADO事件之(5)---FetchProgress (RecordsetEvent) 方法

ado FetchProgress (RecordsetEvent) 方法 该方法在长时间的异步操作期间定期调用,以便报告当前已经恢复(获取)到 Recordset 中的行的数目. 语法 FetchProgress Progress, MaxProgress, adStatus, pRecordset 参数 Progress 长整型,当前已经恢复的记录数. MaxProgress 长整型,可能恢复的最大记录数. adStatus EventStatusEnum 状态值. pRecordset R

浅析ADO 事件模型

ado "ADO 事件模型"支持某些同步或异步的 ADO 操作,这些操作在其开始之前或完成之后能够引发事件."事件"实际上是对事件处理程序例程的调用. 操作开始前调用的事件处理程序用于检查或修改操作参数,此后可删除操作或使其完成.由于 ADO 2.0 支持异步操作,所以操作完成后调用的事件处理程序特别重要.例如,启动异步Recordset.Open 操作的应用程序在操作完成时,通过执行完毕事件来获得通知. 有两类事件: ConnectionEvents - 当连接的