رویدادهای WillExecute و ExecuteComplete ADO
تعریف و استفاده
رویداد یک زیرروند خودکار است که پس از وقوع یک عمل خاص فراخوانی می‌شود.
- رویداد WillExecute قبل از فراخوانی objcomm.Execute, objconn.Execute یا objrs.Open فعال می‌شود
- رویداد ExecuteComplete پس از تکمیل فراخوانی objcomm.Execute, objconn.Execute, objrs.Open, objrs.Requery یا objrs.NextRecordset فعال می‌شود
نحوه استفاده
WillExecute src,cursortyp,locktyp,options,status,objcomm,objrs,objconn ExecuteComplete recaffected,objerror,status,objcomm,objrs,objconn
| پارامتر | توضیح |
|---|---|
| src | رشته‌ای که شامل دستور SQL یا نام پروسه ذخیره شده. |
| cursortyp | تعیین نوع کورسور مورد استفاده.CursorTypeEnum یکی از مقادیر. |
| locktyp | تعیین نوع قفل مورد استفاده.LockTypeEnum یکی از مقادیر. |
| options | یک یا چند CommandTypeEnum یا ExecuteOptionEnum مقدار |
| recaffected | مقدار Long، تعداد رکوردهایی که این دستور تأثیر می‌گذارد. |
| objerror |
Object Error شامل خطاهای رخ داده.
توضیح: مقدار EventStatusEnum باید به adStatusErrorsOccurred تنظیم شود تا Error Object ایجاد شود. |
| status | یک EventStatusEnum مقدار. |
| objcomm |
برای WillExecute: اگر این رویداد توسط Command.Execute ایجاد شده باشد، پارامتر objcomm به Command اشاره دارد و پارامتر objrs به Nothing تنظیم می‌شود. برای ExecuteComplete: Command مورد اجرا شده. |
| objrs |
برای WillExecute: اگر این رخداد توسط Recordset.Open باعث شود، پارامتر objrs به موضوع Recordset اشاره دارد و پارامتر pCommand به Nothing تنظیم می‌شود. برای ExecuteComplete: موضوع Recordset، نتیجه اجرای دستور است. |
| objconn | موضوع Connection مرتبط با اجرای دستور. |
مقدار EventStatusEnum
| مقدار ثابت | مقدار | توضیح |
|---|---|---|
| adStatusOK | 1 | عملی که باعث رخداد شد، موفقیت آمیز بود. |
| adStatusErrorsOccurred | 2 | عملی که باعث رخداد شد، شکست خورد. |
| adStatusCantDeny | 3 | نمی‌توان عمل تعلیق شده را لغو کرد. |
| adStatusCancel | 4 | لغو عملی که باعث رخداد شد. |
| adStatusUnwantedEvent | 5 | ممنوعیت اطلاعیه‌های بعدی قبل از پایان اجرای روش رخداد. |
