ADOWillChangeRecordおよび RecordChangeCompleteイベント_
❮完全なレコードセットオブジェクトリファレンス
WillChangeRecordイベント
WillChangeRecordイベントは、1つ以上のレコードが変更される前にトリガーされます。
注：このイベントが戻る前に、statusパラメーターをadStatusCancelに設定してこのイベントの原因となった操作をキャンセルするか、adStatusUnwantedEventに設定して後続の通知を防止してください。
RecordChangeCompleteイベント
RecordChangeCompleteイベントは、1つ以上のレコードが変更された後にトリガーされます。
注：このメソッドが戻る前に、ステータスパラメーターをadStatusUnwantedEventに設定して、後続の通知を防止します。
注：次のRecordset操作のいずれかを使用してレコードのフィールドを変更すると、WillChangeRecordイベントまたはRecordChangeCompleteイベントが発生する可能性があります：Update、Delete、CancelUpdate、AddNew、UpdateBatch、およびCancelBatch。
構文
WillChangeRecord reason,numrec,status,objRs
RecordChangeComplete reason,numrec,objErr,status,objRs
| Parameter | Description |
|---|---|
| reason | An EventReasonEnum value that specifies the reason for this event |
| numrec | Indicates the number of records affected |
| status | An EventStatusEnum value that indicates the status of the execution of the event |
| objErr | The name of an Error object that describes the error if status is set to adStatusErrorsOccurred, otherwise it is not set |
| objRs | The name of the Recordset Object that triggered this event |
EventReasonEnum値
| Constant | Value | Description |
|---|---|---|
| adRsnAddNew | 1 | An operation added a new record |
| adRsnDelete | 2 | An operation deleted a record |
| adRsnUpdate | 3 | An operation updated an existing record |
| adRsnUndoUpdate | 4 | An operation reversed the update of a record |
| adRsnUndoAddNew | 5 | An operation reversed the addition of a new record |
| adRsnUndoDelete | 6 | An operation reversed the deletion of a record |
| adRsnFirstChange | 11 | An operation made the first change to a record |
EventStatusEnum値
| Constant | Value | Description |
|---|---|---|
| adStatusOK | 1 | The operation that caused the event was successful |
| adStatusErrorsOccurred | 2 | The operation that caused the event failed |
| adStatusCantDeny | 3 | The operation that caused the event cannot be cancelled |
| adStatusCancel | 4 | The operation that caused the event is cancelled |
| adStatusUnwantedEvent | 5 | Prevents subsequent notifications before the event method has finished executing |
❮完全なレコードセットオブジェクトリファレンス