Error-Objekt

Aktualisiert: November 2007

Enthält Informationen über Fehler. Der Error-Konstruktor liegt in zwei Formen vor.

function Error([description : String ])
function Error([number : Number [, description : String ]])

Argumente

• number
  Optional. Ein dem Fehler zugewiesener numerischer Wert, der den Wert der number-Eigenschaft angibt. Null (0), falls das Argument weggelassen wird.

• description
  Optional. Kurze Zeichenfolge, die den Fehler beschreibt und den Startwert der description-Eigenschaft und der message-Eigenschaft angibt. Eine leere Zeichenfolge, falls das Argument weggelassen wird.

Hinweise

Error-Objekte können mithilfe des oben angegebenen Konstruktors explizit erstellt werden. Sie können dem Error-Objekt Eigenschaften hinzufügen, um seine Funktionen zu erweitern. Ein Error-Objekt wird außerdem jedes Mal erstellt, wenn ein Laufzeitfehler auftritt, um den Fehler zu beschreiben.

Typischerweise wird ein Error-Objekt durch die throw-Anweisung ausgelöst, mit der Erwartung, dass es von einer try...catch-Anweisung abgefangen wird. Mit einer throw-Anweisung können Sie jeden beliebigen Datentyp als Fehler übergeben. Die throw-Anweisung erstellt nicht implizit ein Error-Objekt. Wenn jedoch ein Error-Objekt ausgelöst wird, können JScript-Laufzeitfehler und benutzerdefinierte Fehler auf ähnliche Weise von einem catch-Block behandelt werden.

Das Error-Objekt verfügt über vier integrierte Eigenschaften: die Beschreibung des Fehlers (description-Eigenschaft und message-Eigenschaft), die Fehlernummer (number-Eigenschaft) und den Namen des Fehlers (name-Eigenschaft). Die description-Eigenschaft und die message-Eigenschaft beziehen sich auf dieselbe Meldung. Die description-Eigenschaft ermöglicht Abwärtskompatibilität. Die message-Eigenschaft entspricht hingegen dem ECMA-Standard.

Eine Fehlernummer ist ein 32-Bit-Wert. Das obere 16-Bit-Wort ist der Teildienstcode, während das untere Wort den eigentlichen Fehlercode darstellt. Um den tatsächlichen Fehlercode abzulesen, kombinieren Sie die number-Eigenschaft mit dem &-Operator (bitweiser And-Operator) mit der Hexadezimalzahl 0xFFFF.

Vorsicht:
Wenn Sie das Error-Objekt von JScript in einer ASP.NET-Seite verwenden, kann dies zu unbeabsichtigten Ergebnissen führen. Dies liegt an der möglichen Mehrdeutigkeit zwischen dem Error-Objekt von JScript und dem Error-Ereignis der ASP.NET-Seite. Verwenden Sie für die Fehlerbehandlung in ASP.NET-Seiten anstelle des Error-Objekts die System.Exception-Klasse.

Hinweis:

Das Error-Objekt wird nur von Jscript bereitgestellt. Da dieses nicht von einem .NET Framework-Typ abgeleitet wird, kann es von anderen CLS (Common Language Specification-)Sprachen nicht verwendet werden. Achten Sie daher beim Ausstatten der Parameter und Rückgabetypen von CLS‑kompatiblen Methoden mit Typanmerkungen darauf, dass Sie den System.Exception-Datentyp verwenden und nicht das Error-Objekt. Sie können das Error-Objekt jedoch verwenden, um andere Bezeichner als Parameter oder Rückgabetypen mit Typanmerkungen zu versehen. Weitere Informationen hierzu finden Sie unter Schreiben von CLS‑kompatiblem Code.

Beispiel

Das folgende Beispiel veranschaulicht die Verwendung des Error-Objekts.

try {
   // Throw an error.
   throw new Error(42,"No question");
} catch(e) {
   print(e)
// Extract the error code from the error number.
   print(e.number & 0xFFFF)
   print(e.description)
}

Ausgabe dieses Codes:

Error: No question
42
No question

Eigenschaften und Methoden

Eigenschaften und Methoden des Error-Objekts

Anforderungen

Version 5

Siehe auch

Referenz

new-Operator

throw-Anweisung

try...catch...finally-Anweisung

var-Anweisung

Page