Error-Objekt
Das Error-Objekt
Grundsätzlich besitzt jede VB/VBA-Routine automatisch eine Referenz auf das sog. Error-Objekt. Durch die Nutzung einer On Error – Anweisung wird in der jeweiligen Routine der Error-Handler aktiviert, welcher wiederum das Error-Objekt benutzt, um nähere Informationen zu dem aufgetretenen Fehler zu dokumentieren.
Das Error-Objekt besitzt folgende Eigenschaften
| Err | das ErrorObjekt selbst |
| .Number | Gibt einen numerischen Wert zurück oder legt einen numerischen Wert fest, der einen Fehler angibt. Number ist die Standardeigenschaft des Err-Objekts. |
| .Description | Die Einstellung für die Description-Eigenschaft enthält eine kurze Beschreibung des Fehlers. Mit dieser Eigenschaft kann man für Benutzer eine Warnmeldung zu einem Fehler ausgeben, den man nicht verarbeiten kann oder will. |
| .LastDllError | Enthält unter Betriebssystemen vom Typ 32-Bit Microsoft Windows nur den Systemfehler-Code für den letzten Aufruf einer Dynamic Link Library (DLL). |
| .Source | Die Source-Eigenschaft gibt einen Zeichenfolgenausdruck an, der das Objekt darstellt, das den Fehler ursprünglich ausgelöst hat. Der Ausdruck ist normalerweise der Name der Klasse des Objekts oder die Ressource-ID. |
| .HelpFile | Wenn eine Microsoft Windows-Hilfedatei in HelpFile angegeben ist, wird sie automatisch aufgerufen, wenn der Benutzer im Dialogfeld mit der Fehlermeldung die Schaltfläche Hilfe wählt (oder die F1-Taste drückt). |
| .HelpContext | Die HelpContext-Eigenschaft wird verwendet, um automatisch das Hilfethema anzuzeigen, das in der HelpFile-Eigenschaft angegeben ist. |
| .Raise | Raise wird zum Erzeugen von Laufzeitfehlern verwendet und kann anstelle der Error-Anweisung verwendet werden. Raise ist hilfreich beim Erzeugen von Fehlern, wenn man Klassenmodule schreiben, da das Err-Objekt mehr Informationen zur Verfügung stellt als die Error-Anweisung. Mit der Raise-Methode kann zum Beispiel der ursprüngliche Auslöser des Fehlers in der Source-Eigenschaft angegeben werden, oder man kann auf die Hilfe für den Fehler verweisen usw. |
| .Clear | Mit Clear löscht man das Err-Objekt explizit, nachdem ein Fehler verarbeitet wurde. Dies ist zum Beispiel erforderlich, wenn man On Error Resume Next verwendet und die Fehler erst später verarbeitet. Die Clear-Methode wird automatisch aufgerufen, sobald eine der folgenden Anweisungen ausgeführt wird: Alle Arten von Resume-Anweisungen oder Exit Sub, Exit Function, Exit Property bzw. bei jeder On Error-Anweisung |