ClearMacroError-Makroaktion

Einstellung

Die LöschenMakroFehler-Aktion hat keine Argumente.

Hinweise

• Wenn in einem Makro ein Fehler auftritt, werden die Informationen dazu im MacroError-Objekt gespeichert. Wenn Sie Fehlermeldungen nicht mithilfe der BeiFehler-Aktion unterdrückt haben, stoppt das Makro, und die Fehlerinformationen werden in einer Standardfehlermeldung angezeigt. Haben Sie jedoch Fehlermeldungen mithilfe der BeiFehler-Aktion unterdrückt, möchten Sie möglicherweise die im MacroError-Objekt gespeicherten Informationen in einer Bedingung oder in einer benutzerdefinierten Fehlermeldung verwenden.

  Nachdem ein Fehler behandelt wurde, sind die Informationen im MacroError-Objekt veraltet. Daher empfiehlt es sich, das Objekt mithilfe der ClearMacroError-Aktion zu löschen. Auf diese Weise wird die Fehlernummer im MacroError-Objekt auf 0 zurückgesetzt und alle anderen Informationen zum Fehler gelöscht, die im Objekt gespeichert sind, z. B. Fehlerbeschreibung, Makroname, Aktionsname, Bedingung und Argumente. Auf diese Weise können Sie das MacroError-Objekt später erneut überprüfen, um festzustellen, ob ein anderer Fehler aufgetreten ist.

• Da das MacroError-Objekt nach Abschluss eines Makros automatisch gelöscht wird, müssen Sie am Ende eines Makros die LöschenMakroFehler-Aktion nicht verwenden.

• Das MacroError-Objekt enthält Informationen jeweils nur zu einem Fehler. Wenn in einem Makro mehr als ein Fehler aufgetreten ist, enthält das MacroError-Objekt Informationen nur zum letzten Fehler.

• Zur Ausführung der LöschenMakroFehler-Aktion in einem VBA-Modul verwenden Sie die ClearMacroError-Methode des DoCmd-Objekts.

Beispiel

Das folgende Makro verwendet die OnError-Aktion mit dem Argument Next , um Fehlermeldungen zu unterdrücken, und verwendet dann die ÖffnenFormular-Aktion , um ein Formular zu öffnen. In diesem Beispiel wird absichtlich ein Fehler erstellt, indem die GoToRecord-Aktion verwendet wird, um zum vorherigen Datensatz zu wechseln. Die Bedingung [MacroError].[Number]<>0 testet das MacroError-Objekt . Wenn ein Fehler aufgetreten ist, ist die Fehlernummer ungleich 0 (null), und die MsgBox-Aktion wird ausgeführt. Im Meldungsfeld wird der Name der Aktion angezeigt, die den Fehler verursacht hat (in diesem Fall die Aktion GoToRecord ), und die Fehlernummer wird angezeigt. Schließlich löscht die Ausführung der ClearMacroError-Aktion das MacroError-Objekt .