<完全なレコードセットオブジェクト参照
WillChangeRecordイベント
WillChangeRecordイベントは、一つ以上のレコードの変更の前にトリガされます。
Note:このイベントが戻る前に、このイベントを発生させた操作をキャンセルするか、その後のnoticationsを防ぐためにadStatusUnwantedEventに設定するadStatusCancelにステータスパラメータを設定します。
RecordChangeCompleteイベント
一つ以上のレコードが変更された後RecordChangeCompleteイベントがトリガされます。
Note:このメソッドが戻る前に、その後の通知を防ぐためにadStatusUnwantedEventにステータスパラメータを設定します。
Note:次のレコードセットの操作のいずれかを使用して、レコード内のフィールドを変更した場合WillChangeRecordイベントやRecordChangeCompleteイベントが発生する可能性があります更新、削除、のCancelUpdate、AddNewの、UpdateBatchを、およびCancelBatch。
構文
WillChangeRecord reason,numrec,status,objRs
RecordChangeComplete reason,numrec,objErr,status,objRs
| パラメーター | 説明 |
|---|---|
| reason | EventReasonEnumのこのイベントの理由を指定する値 |
| numrec | 影響を受けるレコードの数を示します |
| status | EventStatusEnumのイベントの実行状況を示す値 |
| objErr | ステータスがadStatusErrorsOccurredに設定されている場合、エラーを説明するエラー・オブジェクトの名前は、それ以外の場合は設定されていません |
| objRs | このイベントをトリガしRecordSetオブジェクトの名前 |
EventReasonEnum値
| 定数 | 値 | 説明 |
|---|---|---|
| adRsnAddNew | 1 | 操作は、新しいレコードを追加しました |
| adRsnDelete | 2 | 操作は、レコードを削除しました |
| adRsnUpdate | 3 | 操作は、既存のレコードを更新します |
| adRsnUndoUpdate | 4 | 操作は、レコードの更新を逆転しました |
| adRsnUndoAddNew | 5 | 操作は、新しいレコードの追加を逆転しました |
| adRsnUndoDelete | 6 | 操作は、レコードの削除を逆転しました |
| adRsnFirstChange | 11 | 操作は、レコードに最初の変更を行いました |
EventStatusEnum値
| 定数 | 値 | 説明 |
|---|---|---|
| adStatusOK | 1 | イベントを発生させた操作は正常に終了しました |
| adStatusErrorsOccurred | 2 | イベントを発生させた操作に失敗しました |
| adStatusCantDeny | 3 | イベントの原因となった操作をキャンセルすることができません |
| adStatusCancel | 4 | イベントを発生させた操作がキャンセルされます |
| adStatusUnwantedEvent | 5 | イベントメソッドの実行が完了する前に、後続の通知を防ぎます |
<完全なレコードセットオブジェクト参照