أحدث البرامج التعليمية وتطوير الشبكة
 

ADO WillExecute وExecuteComplete الأحداث


<كاملة كائن اتصال المرجعي

حدث هو روتين يمكن أن يطلق عليها تلقائيا بعد وقوع عملية محددة.

  • و 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 عدد السجلات التي تأثرت تنفيذ
objerror كائن خطأ الذي يحتوي على الأخطاء التي وقعت

Note: يجب تعيين قيمة EventStatusEnum إلى adStatusErrorsOccurred لإنشاء الكائن خطأ

status و EventStatusEnum قيمة
objcomm ل WillExecute : تعيين لكائن الأوامر التي تم تنفيذها أو لا شيء

ل ExecuteComplete : الكائن القيادة التي تم تنفيذها

objrs ل WillExecute : تعيين إلى كائن مجموعة السجلات التي نتجت عن تنفيذ الأمر أو لا شيء

ل ExecuteComplete : الكائن السجلات التي هي نتيجة الأمر تنفيذه

objconn كائن اتصال مقترن تنفيذ الأمر

قيم CursorTypeEnum

يحدد نوع المؤشر المستخدم في كائن مجموعة السجلات.

ثابت القيمة وصف
adOpenUnspecified-1 لا تحدد نوع من المؤشر.
adOpenForwardOnly0 افتراضي. يستخدم المؤشر إلى الأمام فقط. متطابقة إلى مؤشر ثابت، إلا أنه يمكنك التمرير إلى الأمام إلا من خلال السجلات. هذا يحسن الأداء عند الحاجة إلى جعل مرور واحد فقط من خلال السجلات.
adOpenKeyset1 يستخدم مؤشر مجموعة المفاتيح. مثل مؤشر ديناميكي، إلا أنه لا يمكنك مشاهدة السجلات أن المستخدمين الآخرين إضافة، على الرغم من أن السجلات التي حذف المستخدمين الآخرين لا يمكن الوصول إليها من السجلات الخاصة بك. تغييرات البيانات من قبل المستخدمين الآخرين لا تزال مرئية.
adOpenDynamic2 يستخدم مؤشر ديناميكي. الإضافات، والتغييرات، والحذف من قبل المستخدمين الآخرين واضحة، ويسمح لجميع أنواع الحركة من خلال السجلات، باستثناء العناوين، وإذا لم تقدم الدعم لهم.
adOpenStatic3 يستخدم المؤشر ثابت. نسخة ثابتة من مجموعة من السجلات التي يمكنك استخدامها للعثور على البيانات أو توليد التقارير. الإضافات، والتغيرات، أو الحذف من قبل مستخدمين آخرين غير مرئية.

قيم LockTypeEnum

ثابت القيمة وصف
adLockUnspecified-1 لا تحدد نوع من القفل. للاستنساخ، يتم إنشاء نسخة مع نفس نوع تأمين مثل الأصلي.
adLockReadOnly1 يشير قراءة فقط السجلات. لا يمكنك تغيير البيانات.
adLockPessimistic2 يشير تأمين متشائم، من السجلات. مقدم يفعل ما هو ضروري لضمان نجاح التحرير من السجلات، عادة عن طريق تأمين السجلات في مصدر البيانات مباشرة بعد التحرير.
adLockOptimistic3 يشير تأمين متفائل، من السجلات. يستخدم مزود تأمين متفائل، وتأمين السجلات فقط عند استدعاء أسلوب التحديث.
adLockBatchOptimistic4 يشير التحديثات دفعة تفاؤلا. اللازمة لوضع تحديث دفعة واحدة.

قيم CommandTypeEnum

ثابت القيمة وصف
adCmdUnspecified-1 لا تحدد وسيطة نوع الأوامر.
adCmdText1 يقيم CommandText كتعريف نصية من أمر أو استدعاء الإجراء المخزن.
adCmdTable2 يقيم CommandText كاسم الجدول الذي تم إرجاعها من قبل جميع استعلام SQL المولدة داخليا الأعمدة.
adCmdStoredProc4 يقيم CommandText كاسم الإجراء المخزن.
adCmdUnknown8 يشير إلى أن نوع القيادة في خاصية CommandText غير معروف.
adCmdFile256 يقيم CommandText مثل اسم الملف من السجلات المخزنة باستمرار. استخدامها مع Recordset.Open أو إعادة الاستعلام فقط.
adCmdTableDirect512 يقيم CommandText كاسم الجدول الذي يتم إرجاع كافة الأعمدة. استخدامها مع Recordset.Open أو إعادة الاستعلام فقط. لاستخدام أسلوب بحث، يجب فتح مجموعة السجلات مع adCmdTableDirect. لا يمكن الجمع بين هذه القيمة مع قيمة adAsyncExecute ExecuteOptionEnum.

قيم ExecuteOptionEnum

ثابت القيمة وصف
adOptionUnspecified-1 يشير إلى أن الأمر غير محدد.
adAsyncExecute16 يشير إلى أن الأمر يجب أن ينفذ بشكل غير متزامن. لا يمكن الجمع بين هذه القيمة مع قيمة adCmdTableDirect CommandTypeEnum.
adAsyncFetch32 يشير إلى أن الصفوف المتبقية بعد كمية الأولية المحددة في الخاصية CacheSize يجب استردادها بشكل غير متزامن.
adAsyncFetchNonBlocking64 يشير إلى أن موضوع الرئيسي أبدا كتل أثناء استرداد. إذا لم يتم جلب الصف المطلوبة، الصف الحالي تنتقل تلقائيا إلى نهاية الملف. إذا قمت بفتح السجلات من تيار تحتوي على السجلات المخزنة باستمرار، سوف adAsyncFetchNonBlocking لا يكون لها تأثير. فإن العملية ستكون متزامن وحظر. adAsynchFetchNonBlocking له تأثير عند استخدام الخيار adCmdTableDirect لفتح مجموعة السجلات.
adExecuteNoRecords128 يشير إلى أن نص الأمر هو أمر أو الإجراء المخزن الذي لا عودة الصفوف (for example, a command that only inserts data) . إذا يتم استرداد أية صفوف، يتم التخلص منها وعدم إرجاعها. يمكن أن تنتقل adExecuteNoRecords فقط كمعلمة اختيارية للقيادة أو اتصال تنفيذ الأسلوب.
adExecuteStream256 يشير إلى أن نتائج تنفيذ الأمر يجب أن يتم إرجاع ك دفق. يمكن أن تنتقل adExecuteStream فقط كمعلمة اختياري لقيادة تنفيذ الأسلوب.
adExecuteRecord512 يشير إلى أن CommandText هو أمر أو إجراء مخزن يقوم بإرجاع صف واحد والتي ينبغي أن تعاد ككائن سجل.

قيم EventStatusEnum

ثابت القيمة وصف
adStatusOK1 وكانت العملية التي أطلق الحدث ناجحة
adStatusErrorsOccurred2 العملية التي أطلق الحدث فشلت
adStatusCantDeny3 لا يمكن إلغاء عملية معلقة
adStatusCancel4 يلغي العملية التي أطلق الحدث
adStatusUnwantedEvent5 يمنع الإخطارات اللاحقة قبل انتهاء طريقة الحدث تنفيذ

<كاملة كائن اتصال المرجعي