Err-Objekt

Enthält Informationen zu Laufzeitfehlern.

Hinweise

Die Eigenschaften des Err-Objekts werden durch den Auslöser eines Fehlers festgelegt, das heißt durch Visual Basic, ein Objekt oder den Programmierer.

Die Standardeigenschaft eines Err-Objekts ist Number. Da die Standardeigenschaft durch den Objektnamen Err dargestellt werden kann, muss bereits bestehender Code, der mit der Err-Funktion oder der Err-Anweisung geschrieben wurde, nicht geändert werden.

Bei einem Laufzeitfehler werden die Eigenschaften des Err -Objekts mit Informationen gefüllt, mit denen der Fehler eindeutig beschrieben wird, sowie mit Informationen, mit denen der Fehler behandelt werden kann. Um einen Laufzeitfehler im Code zu generieren, verwenden Sie die Raise-Methode.

Die Eigenschaften des Err-Objekts werden nach einer Exit Sub-, Exit Function-, Exit Property- oder Resume Next-Anweisung innerhalb einer Fehlerbehandlungsroutine auf null oder eine leere Zeichenfolge ("") zurückgesetzt. Die Verwendung jeder beliebigen Form von Resume-Anweisung außerhalb einer Fehlerbehandlungsroutine setzt die Eigenschaften des Err-Objekts nicht zurück. Die Clear-Methode kann verwendet werden, um Err explizit zurückzusetzen.

Verwenden Sie die Raise-Methode anstelle der Err-Anweisung zum Generieren von Laufzeitfehlern und Klassenmodulen. Das Verwenden der Raise-Methode in anderem Code hängt vom Umfang der Informationen ab, die Sie zurückgeben möchten.

Das Err-Objekt ist ein integriertes Objekt mit globalem Umfang. Es ist nicht erforderlich, eine Instanz des Objekts im Code zu erstellen.

Beispiel

Dieses Beispiel verwendet die Eigenschaften des Err-Objekts (Number, Description, HelpContext, HelpFile, Source) beim Erstellen eines Fehlermeldungs-Dialogfelds.

Beachten Sie Folgendes, wenn Sie zuerst die Clear -Methode verwenden: Beim Generieren eines Visual Basic-Fehlers mit der Raise -Methode werden die Standardwerte von Visual Basic zu den Eigenschaften des Err -Objekts.

Dim Msg
' If an error occurs, construct an error message
On Error Resume Next    ' Defer error handling.
Err.Clear
Err.Raise 6    ' Generate an "Overflow" error.
' Check for error, then show message.
If Err.Number <> 0 Then
    Msg = "Error # " & Str(Err.Number) & " was generated by " _
            & Err.Source & Chr(13) & Chr(13) & Err.Description
    MsgBox Msg, vbMsgBoxHelpButton, "Error", Err.Helpfile, Err.HelpContext
End If

Siehe auch

• Anweisungen (Visual Basic for Applications)
• Behandeln von Laufzeitfehlern in VBA
• Abfangbare Fehler
• Objekte (Visual Basic for Applications)
• Objektbibliothekreferenz für Office (Mitglieder, Eigenschaften, Methoden)

Support und Feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.