פעולת המאקרו ClearMacroError

הגדרה

הפעולה ClearMacroError לא מכילה ארגומנטים כלשהם.

הערות

• כאשר מתרחשת שגיאה במאקרו, מידע על השגיאה מאוחסן באובייקט MacroError‏. אם לא השתמשת בפעולה OnError כדי להעלים הודעות שגיאה, המאקרו מפסיק לפעול ופרטי השגיאה מוצגים בהודעת שגיאה רגילה. עם זאת, אם השתמשת בפעולה OnError כדי להעלים הודעות שגיאה, כדאי להשתמש במידע המאוחסן באובייקט MacroError‏ בתנאי או בהודעת שגיאה מותאמת אישית.

  לאחר הטיפול בשגיאה, המידע באובייקט MacroError‏ כבר אינו מעודכן, ולכן מומלץ לנקות את האובייקט באמצעות הפעולה ClearMacroError. פעולה זו מאפסת את מספר השגיאה באובייקט MacroError‏ ל- 0 ומנקה את כל המידע האחר על השגיאה המאוחסן באובייקט, כגון תיאור השגיאה, שם המאקרו, שם הפעולה, התנאי והארגומנטים. כך תוכל לבחון את האובייקט MacroError‏ שוב מאוחר יותר כדי לבדוק אם אירעה שגיאה אחרת.

• האובייקט MacroError‏ מנוקה באופן אוטומטי כאשר מאקרו כלשהו מסתיים, כך שאין צורך להשתמש בפעולה ClearMacroError בסוף כל מאקרו.

• האובייקט MacroError‏ מכיל מידע על שגיאה אחת בלבד בכל פעם. אם אירעה יותר משגיאה אחת במאקרו בבת אחת, האובייקט MacroError‏ מכיל מידע על השגיאה האחרונה בלבד.

• כדי להפעיל את הפעולה ClearMacroError במודול ‏VBA, השתמש בפעולת השירות ClearMacroError של האובייקט DoCmd.

דוגמה

המאקרו הבא משתמש בפעולה OnError עם הארגומנט הבא כדי להעלים הודעות שגיאה, ולאחר מכן משתמש בפעולה OpenForm כדי לפתוח טופס. עבור דוגמה זו, נוצרה שגיאה במכוון על-ידי שימוש בפעולה GoToRecord למעבר לרשומה הקודמת. התנאי ‎[MacroError].[Number]<>0 בודק את האובייקט MacroError. אם אירעה שגיאה, מספר השגיאה אינו אפס והפעולה MsgBox מתבצעת. תיבת ההודעה מציגה את שם פעולה שגרמה לשגיאה (במקרה זה, הפעולה GoToRecord) ומספר השגיאה מוצג. לבסוף, ביצוע הפעולה ClearMacroError מנקה את האובייקט MacroError‏.