您正在查看: 标签 参数设置 下的文章

WillChangeRecord 和 RecordChangeComplete (ConnectionEvent) 方法 (ADO)

WillChangeRecord 和 RecordChangeComplete (ConnectionEvent) 方法 (ADO)

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

语法

WillChangeRecord adReason, cRecords, adStatus, pRecordset

RecordChangeComplete adReason, cRecords, pError, adStatus, pRecordset

参数

adReason EventReasonEnum 值,指定该事件的原因。它的值可以是 adRsnAddNewadRsnDeleteadRsnUpdateadRsnUndoUpdateadRsnUndoAddNewadRsnUndoDeleteadRsnFirstChange

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

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

adStatus EventStatusEnum 状态值。

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

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

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

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

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

说明

WillChangeRecordRecordChangeComplete 事件可因下列 Recordset 操作而发生:UpdateDeleteCancelUpdateAddNewUpdateBatchCancelBatch

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

WillMove 和 MoveComplete (ConnectionEvent) 方法 (ADO)

WillMove 和 MoveComplete (ConnectionEvent) 方法 (ADO)

WillMove 方法在挂起操作更改 Recordset 中的当前位置调用。MoveComplete 方法则在 Recordset 的当前位置更改调用。

语法

WillMove adReason, adStatus, pRecordset

MoveComplete adReason, pError, adStatus, pRecordset

参数

adReason EventReasonEnum 值,指定该事件的原因。它的值可以是 adRsnMoveFirstadRsnMoveLastadRsnMoveNextadRsnMovePreviousadRsnMoveadRsnRequery

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

adStatus EventStatusEnum 状态值。

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

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

WillMove 返回前,将该参数设置为 adStatusCancel 可请求取消挂起的操作。在 MoveComplete 返回前,将该参数设置为 adStatusUnwantedEvent 可避免后续的通知。

pRecordset Recordset 对象。发生该事件所针对的记录集。

说明

WillMoveMoveComplete 事件可因下列 Recordset 操作而发生:OpenMoveMoveFirstMoveLastMoveNextMovePreviousBookmarkAddNewDeleteRequeryResync

WillConnect (ConnectionEvent) 方法 (ADO)

WillConnect (ConnectionEvent) 方法 (ADO)

该方法在连接启动调用。在挂起连接中使用的参数将作为输入参数提供,并可在方法返回之前进行修改。该方法可以返回取消挂起连接的请求。

语法

WillConnect ConnectionString, UserID, Password, Options, adStatus, pConnection

参数

ConnectionString 字符串,包含有关挂起连接的连接信息。

UserID 字符串,包含挂起连接的用户名。

Password 字符串,包含挂起连接的密码。

Options 长整型值,指明提供者应如何计算 ConnectionString。对于可接受值的列表,参见 CommandType 属性。

adStatus EventStatusEnum 状态值。

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

在该方法返回前,将该参数设置为 adStatusUnwantedEvent 以避免后续的通知。将该参数设置为 adStatusCancel 以请求引起取消该通知的连接操作。

pConnection 该事件通知所针对的 Connection 对象。

说明

当调用该方法时,ConnectionStringUserIDPasswordOptions 参数设置为引发该事件的操作所建立的值。

当取消该方法时,将调用 ConnectComplete,并且它的 adStatus 参数将设置为 adStatusErrorsOccurred

WillExecute (ConnectionEvent) 方法 (ADO)

WillExecute (ConnectionEvent) 方法 (ADO)

该方法在对该连接执行挂起命令之前调用,并允许用户检查和修改挂起的执行参数。该方法可返回取消挂起命令的请求。

语法

WillExecute Source, CursorType, LockType, Options, adStatus, pCommand, pRecordset, pConnection

参数

Source 字符串,包含 SQL 命令或存储过程名称。

CursorType CursorTypeEnum,包含游标类型,用于将要打开的记录集。当调用该方法时,如果该参数设置为 adOpenUnspecified,则不可对其进行更改。

LockType LockTypeEnum,包含锁定类型,用于将要打开的记录集。当调用该方法时,如果该参数设置为 adLockUnspecified,则不可对其进行更改。

Options 长整型值选项,用于执行命令或打开记录集。

adStatus EventStatusEnum 状态值,在调用该方法时它可以是 adStatusCantDenyadStatusOK。当其为 adStatusCantDeny 时,该方法可能未请求取消挂起操作。

在此方法返回前,将该参数设置为 adStatusUnwantedEvent 可以避免后续的通知,或者设置为 adStatusCancel 以请求取消引发该事件的操作。

pCommand 该事件通知所针对的 Command 对象。

pRecordset 该事件通知所针对的 Recordset 对象。

pConnection 该事件通知所针对的 Connection 对象。

说明

WillExecute 事件可能因 Connection.ExecuteCommand.ExecuteRecordset.Open 而发生。相应的 pConnectionpCommandpRecordset 参数将设置为引发事件的对象,而其余的两个将设置为 Nothing

WillChangeRecordset 和 RecordsetChangeComplete (ConnectionEvent) 方法 (ADO)

WillChangeRecordset 和 RecordsetChangeComplete (ConnectionEvent) 方法 (ADO)

WillChangeRecordset 方法在挂起的操作更改 Recordset 调用。RecordsetChangeComplete 方法在 Recordset 更改调用。

语法

WillChangeRecordset adReason, adStatus, pRecordset

RecordsetChangeComplete adReason, pError, adStatus, pRecordset

参数

adReason EventReasonEnum 值,指定该事件的原因。它的值可以是 adRsnReQueryadRsnReSynchadRsnCloseadRsnOpen

adStatus EventStatusEnum 状态值。

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

当调用 RecordsetChangeComplete 时,如果引发事件的操作成功,则该参数设置为 adStatusOK;如果操作失败,则设置为 adStatusErrorsOccurred;如果与以前接受的 WillChangeRecordset 事件关联的操作已经取消,则设置为 adStatusCancel

WillChangeRecordset 返回前,将该参数设置为 adStatusCancel 以请求取消挂起操作。

WillChangeRecordsetRecordsetChangeComplete 返回前,将该参数设置为 adStatusUnwantedEvent 可避免后续的通知。

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

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

说明

WillChangeRecordsetRecordsetChangeComplete 事件可因下列 Recordset 操作而发生:RequeryResyncCloseOpenFilter