حدثي ADO WillExecute و ExecuteComplete
الـ Definition وـ Usage
الـ Event هي عملية فرعية يتم تفعيلها تلقائيًا بعد إتمام عملية معينة.
- يُطلق حدث WillExecute قبل إجراء الـ Call على objcomm.Execute, objconn.Execute أو objrs.Open.
- يُطلق حدث ExecuteComplete بعد إكمال الـ Call على objcomm.Execute, objconn.Execute, objrs.Open, objrs.Requery أو objrs.NextRecordset.
الـ Syntax
WillExecute src,cursortyp,locktyp,options,status,objcomm,objrs,objconn ExecuteComplete recaffected,objerror,status,objcomm,objrs,objconn
| المُدخل | الوصف |
|---|---|
| src | الـ String الذي يحتوي على أمر SQL أو اسم مخزن الإجراء. |
| cursortyp | يحدد النوع الذي يجب استخدامه للـ Cursor.CursorTypeEnum من القيم. |
| locktyp | يحدد النوع الذي يجب استخدامه للـ Lock.LockTypeEnum من القيم. |
| options | أحد أو أكثر CommandTypeEnum أو ExecuteOptionEnum القيمة |
| recaffected | قيمة Long،عدد السجلات التي أثرت عليها الأوامر. |
| objerror |
مثل الـ Error الذي يحتوي على الأخطاء التي حدثت.
التعليق: يجب أن يتم تعيين قيمة EventStatusEnum إلى adStatusErrorsOccurred لإنشاء هذا الـ Error. |
| status | واحد EventStatusEnum القيمة. |
| objcomm |
بالنسبة لـ WillExecute: إذا تم إطلاق هذا الحدث بواسطة Command.Execute،سيقوم objcomm بالإشارة إلى الـ Command،وسيتم تعيين objrs إلى Nothing. بالنسبة لـ ExecuteComplete: الـ Command المُتأثـر. |
| objrs |
بالنسبة لـ WillExecute: إذا تم إطلاق هذا الحدث بواسطة Recordset.Open، سيقوم objrs بمرجع Recordset Object، وسيتم إعداد pCommand على Nothing. بالنسبة لـ ExecuteComplete: Recordset Object، هو نتيجة تنفيذ الأمر. |
| objconn | مثل Connection Object مرتبط بتنفيذ الأمر. |
قيم EventStatusEnum
| المستويات | القيمة | الوصف |
|---|---|---|
| adStatusOK | 1 | نجح العمل الذي أحدث هذا الحدث. |
| adStatusErrorsOccurred | 2 | فشل العمل الذي أحدث هذا الحدث. |
| adStatusCantDeny | 3 | لا يمكن إلغاء العمل المعلق. |
| adStatusCancel | 4 | إلغاء العمل الذي أدى إلى الحدث. |
| adStatusUnwantedEvent | 5 | منع الإخطارات التالية قبل إنهاء تنفيذ طريقة الحدث. |
