WillChangeRecord および RecordChangeComplete イベント (ADO)WillChangeRecord and RecordChangeComplete Events (ADO)

WillChangeRecordイベントが 1 つまたは複数のレコード (行) の前に呼び出されます、 Recordsetを変更します。The WillChangeRecord event is called before one or more records (rows) in the Recordset change. RecordChangeCompleteイベントが呼び出された後に 1 つまたは多くのレコードを変更します。The RecordChangeComplete event is called after one or more records change.

構文Syntax

  
WillChangeRecord adReason, cRecords, adStatus, pRecordset  
RecordChangeCompleteadReason, cRecords, pError, adStatus, pRecordset  

パラメーターParameters

adReasonadReason
EventReasonEnumこのイベントの理由を指定する値。An EventReasonEnum value that specifies the reason for this event. その値を指定できますadRsnAddNewadRsnDeleteadRsnUpdateadRsnUndoUpdateadRsnUndoAddNewadRsnUndoDelete、またはadRsnFirstChangeします。Its value can be adRsnAddNew, adRsnDelete, adRsnUpdate, adRsnUndoUpdate, adRsnUndoAddNew, adRsnUndoDelete, or adRsnFirstChange.

cRecordscRecords
A長い(影響) を変更するレコードの数を示す値。A Long value that indicates the number of records changing (affected).

pErrorpError
エラーオブジェクト。An Error object. 場合に発生したエラーを説明の値adStatusadStatusErrorsOccurred; 未設定がそれ以外の場合。It describes the error that occurred if the value of adStatus is adStatusErrorsOccurred; otherwise it is not set.

adStatusadStatus
EventStatusEnum状態値。An EventStatusEnum status value.

ときにWillChangeRecordが呼び出されると、このパラメーターを設定adStatusOKイベントの原因となった操作が成功した場合。When WillChangeRecord is called, this parameter is set to adStatusOK if the operation that caused the event was successful. 設定されているadStatusCantDeny場合、このイベントは、保留中の操作のキャンセルを要求できません。It is set to adStatusCantDeny if this event cannot request cancellation of the pending operation.

ときにRecordChangeCompleteが呼び出されると、このパラメーターを設定adStatusOKイベントの原因となった操作が成功した場合またはadStatusErrorsOccurred場合操作に失敗しました。When RecordChangeComplete is called, this parameter is set to adStatusOK if the operation that caused the event was successful, or to adStatusErrorsOccurred if the operation failed.

前にWillChangeRecord戻り値は、このパラメーターに設定するadStatusCancelこのイベントを発生したか、このパラメーターに設定する操作のキャンセルを要求adStatusUnwantedEvent後続通知しないように設定します。Before WillChangeRecord returns, set this parameter to adStatusCancel to request cancellation of the operation that caused this event or set this parameter to adStatusUnwantedEvent to prevent subsequent notifications.

前にRecordChangeComplete戻り値は、このパラメーターに設定するadStatusUnwantedEvent後続通知しないように設定します。Before RecordChangeComplete returns, set this parameter to adStatusUnwantedEvent to prevent subsequent notifications.

pRecordsetpRecordset
A Recordsetオブジェクト。A Recordset object. Recordsetのこのイベントが発生しました。The Recordset for which this event occurred.

コメントRemarks

A WillChangeRecordまたはRecordChangeComplete 、以下の理由により行の最初の変更されたフィールドのイベントが発生するRecordset操作。Update削除CancelUpdateAddNewUpdateBatch、およびCancelBatch.A WillChangeRecord or RecordChangeComplete event may occur for the first changed field in a row due to the following Recordset operations: Update, Delete, CancelUpdate, AddNew, UpdateBatch, and CancelBatch. 値、 Recordset CursorTypeイベントが発生する操作を指定します。The value of the Recordset CursorType determines which operations cause the events to occur.

中に、 WillChangeRecord 、イベント、レコード セットフィルタープロパティに設定されてadFilterAffectedRecordsします。During the WillChangeRecord event, the Recordset Filter property is set to adFilterAffectedRecords. イベントの処理中に、このプロパティを変更することはできません。You cannot change this property while processing the event.

設定する必要があります、 adStatusパラメーターをadStatusUnwantedEventの可能性のある各adReason値が含まれるすべてのイベントのイベント通知を完全に停止するにはadReasonパラメーター。You must set the adStatus parameter to adStatusUnwantedEvent for each possible adReason value to completely stop event notification for any event that includes an adReason parameter.

関連項目See Also

ADO イベント モデルの例 (vc++) ADO Events Model Example (VC++)
ADO イベント ハンドラーの概要ADO Event Handler Summary