إجراء الماكرو OnError

ينطبق على
Access لـ Microsoft 365 Access 2024 Access 2021 Access 2019 Access 2016

يمكنك استخدام إجراء الماكرو OnError في Access لتحديد ما يجب أن يحدث عند حدوث خطأ في الماكرو.

ملاحظة

لا يتوفر إجراء الماكرو OnError في تطبيقات Access على ويب.

الإعداد

يحتوي إجراء الماكرو OnError على الوسيطات التالية.

وسيطة الإجراء الوصف
الانتقال إلى تحديد السلوك العام الذي يجب أن يحدث عند مواجهة خطأ. انقر فوق سهم القائمة المنسدلة، ثم فوق أحد الإعدادات التالية:

التالي: يسجل Access تفاصيل الخطأ في العنصر MacroError ولكنه لا يوقف الماكرو. يتابع الماكرو مع الإجراء التالي.

اسم الماكرو: يوقف Access الماكرو الحالي ويقوم بتشغيل الماكرو الذي تم تسميته في وسيطة "اسم الماكرو ".

فشل: يوقف Access الماكرو الحالي ويعرض رسالة خطأ.
اسم الماكرو إذا تم تعيين الوسيطة "الانتقال إلى " إلى "اسم الماكرو"، فاكتب اسم الماكرو الفرعي المطلوب استخدامه لمعالجة الأخطاء. يجب أن يتطابق الاسم الذي تكتبه مع اسم الماكرو الفرعي في الماكرو الحالي؛ لا يمكنك إدخال اسم لعنصر ماكرو مختلف. في المثال أدناه، الماكرو الفرعي ErrorHandler موجود في كائن الماكرو نفسه مثل إجراء الماكرو OnError .
يجب ترك هذه الوسيطة فارغة إذا تم تعيين الوسيطة "الانتقال إلى " إلى "التالي " أو "فشل".

ملاحظات

  • يتم عادة وضع إجراء الماكرو OnError في بداية الماكرو، ولكن يمكنك أيضا وضع الإجراء لاحقا في الماكرو. تدخل القواعد التي تم وضعها بواسطة الإجراء حيز التنفيذ عند تشغيل الإجراء.
  • إذا قمت بتعيين الوسيطة "الانتقال إلى " إلى "فشل"، فسيعمل Access بنفس الطريقة التي كان يعمل بها لو لم يكن هناك إجراء OnError في الماكرو. أي، إذا تمت مصادفة خطأ، يقوم Access بإيقاف الماكرو ويعرض رسالة خطأ قياسية. يتمثل الاستخدام الرئيسي لإعداد الفشل في إيقاف تشغيل معالجة أي أخطاء قمت بإنشائها مسبقا في ماكرو.

مثال

يوضح الماكرو التالي استخدام إجراء الماكرو OnError . في هذا المثال، يحدد الإجراء OnError أن Access يقوم بتشغيل الماكرو الفرعي لمعالجة الأخطاء المخصصة الذي يُسمى ErrorHandler عند حدوث خطأ ما. إذا حدث خطأ في أي من الإجراءات التالية، ينتقل Access إلى الماكرو الفرعي ErrorHandler. يعرض الماكرو الفرعي ErrorHandler مربع رسالة يُشير إلى العنصر MacroError لعرض معلومات حول الخطأ.

اسم الماكرو الفرعي الإجراء الوسيطات
OnError انتقل إلى: اسم الماكرو
اسم الماكرو: ErrorHandler
[الإجراء 2]
...
[الإجراء n]
ErrorHandler MessageBox الرسالة: ="خطأ # " & [MacroError]. [Number] & " on " & [MacroError]. [ActionName] & "الإجراء".
تنبيه: نعم
النوع: لا يوجد
العنوان: حدث خطأ

فيما يلي لقطة شاشة لمصمم ماكرو Access مع المثال السابق. في هذه الحالة، يؤدي التعبير الموجود في الإجراء SetLocalVar إلى ظهور خطأ ما لأنه يحاول قسمة رقم على صفر. ينتقل Access إلى الأسفل وصولاً إلى الماكرو الفرعي الذي يُسمى ErrorHandler ويعرض معلومات الخطأ في مربع رسالة.

سطح تصميم ماكرو Access يعرض إجراء الماكرو OnError.