ADO الأحداث WillChangeRecord و RecordChangeComplete
استكمال مرجع كائن مجموعة السجلات
حدث WillChangeRecord
يتم تشغيل الحدث WillChangeRecord قبل تغيير سجل واحد أو أكثر.
ملاحظة: قبل عودة هذا الحدث ، قم بتعيين معلمة الحالة على adStatusCancel لإلغاء العملية التي تسببت في هذا الحدث أو تعيينها على adStatusUnwantedEvent لمنع الملاحظات اللاحقة.
حدث RecordChangeComplete
يتم تشغيل الحدث RecordChangeComplete بعد تغيير سجل واحد أو أكثر.
ملاحظة: قبل عودة هذه الطريقة ، اضبط معلمة الحالة على adStatusUnwantedEvent لمنع الإشعارات اللاحقة.
ملاحظة: قد يقع الحدث WillChangeRecord أو حدث RecordChangeComplete إذا قمت بتغيير حقل في أحد السجلات باستخدام إحدى عمليات مجموعة السجلات التالية: Update، Delete، CancelUpdate، AddNew، UpdateBatch، and 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 |
استكمال مرجع كائن مجموعة السجلات