Err-ObjektErr object

Enthält Informationen zu Laufzeitfehlern.Contains information about run-time errors.

HinweiseRemarks

Die Eigenschaften des Err-Objekts werden durch den Auslöser eines Fehlers festgelegt, das heißt durch Visual Basic, ein Objekt oder den Programmierer.The properties of the Err object are set by the generator of an error—Visual Basic, an object, or the programmer.

Die Standardeigenschaft eines Err-Objekts ist Number.The default property of the Err object is 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.Because the default property can be represented by the object name Err, earlier code written by using the Err function or Err statement doesn't have to be modified.

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.When a run-time error occurs, the properties of the Err object are filled with information that uniquely identifies the error and information that can be used to handle it. Um einen Laufzeitfehler im Code zu generieren, verwenden Sie die Raise-Methode.To generate a run-time error in your code, use the Raise method.

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.The Err object's properties are reset to zero or zero-length strings ("") after an Exit Sub, Exit Function, Exit Property, or Resume Next statement within an error-handling routine. Die Verwendung jeder beliebigen Form von Resume-Anweisung außerhalb einer Fehlerbehandlungsroutine setzt die Eigenschaften des Err-Objekts nicht zurück.Using any form of the Resume statement outside of an error-handling routine will not reset the Err object's properties. Die Clear-Methode kann verwendet werden, um Err explizit zurückzusetzen.The Clear method can be used to explicitly reset Err.

Verwenden Sie die Raise-Methode anstelle der Err-Anweisung zum Generieren von Laufzeitfehlern und Klassenmodulen.Use the Raise method, rather than the Error statement, to generate run-time errors for system errors and class modules. Das Verwenden der Raise-Methode in anderem Code hängt vom Umfang der Informationen ab, die Sie zurückgeben möchten.Using the Raise method in other code depends on the richness of the information that you want to return.

Das Err-Objekt ist ein integriertes Objekt mit globalem Umfang.The Err object is an intrinsic object with global scope. Es ist nicht erforderlich, eine Instanz des Objekts im Code zu erstellen.There is no need to create an instance of it in your code.

BeispielExample

Dieses Beispiel verwendet die Eigenschaften des Err-Objekts (Number, Description, HelpContext, HelpFile, Source) beim Erstellen eines Fehlermeldungs-Dialogfelds.This example uses the properties of the Err object (Number, Description, HelpContext, HelpFile, Source) in constructing an error-message dialog box.

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.Note that if you use the Clear method first, when you generate a Visual Basic error with the Raise method, Visual Basic's default values become the properties of the Err object.

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) & Err.Description
    MsgBox Msg, , "Error", Err.Helpfile, Err.HelpContext
End If

Siehe auchSee also

Support und FeedbackSupport and feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation?Have questions or feedback about Office VBA or this documentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.