Erweiterungen des Typs Error

Aktualisiert: November 2007

Statische Funktionen zur Erweiterung des integrierten ECMAScript (JavaScript)-Typs Error mithilfe von Ausnahmedetails und der Unterstützung von Anwendungskompilierungsmodi (Debug- oder Releasemodus).

Namespace: keiner. Diese Typerweiterung ist global und kein Teil eines Namespace.

Vererbung: keine

var err = Error.create(message, errorInfo);

Membererweiterungen

Name	Beschreibung
Error.argument-Funktion	Erstellt ein Error-Objekt, das die Sys.ArgumentException-Ausnahme darstellt.
Error.argumentNull-Funktion	Erstellt ein Error-Objekt, das die Sys.ArgumentNullException-Ausnahme darstellt.
Error.argumentOutOfRange-Funktion	Erstellt ein Error-Objekt, das die Sys.ArgumentOutOfRangeException-Ausnahme darstellt.
Error.argumentType-Funktion	Erstellt ein Error-Objekt, das die Sys.ArgumentTypeException-Ausnahme darstellt.
Error.argumentUndefined-Funktion	Erstellt ein Error-Objekt, das die Sys.ArgumentUndefinedException-Ausnahme darstellt.
Error.create-Funktion	Erstellt ein Error-Objekt, das optionale zusätzliche Fehlerinformationen enthält.
Error.format-Funktion	Erstellt ein Error-Objekt, das die Sys.FormatException-Ausnahme darstellt.
Error.invalidOperation-Funktion	Erstellt ein Error-Objekt, das die Sys.InvalidOperationException-Ausnahme darstellt.
Error.message-Feld	Stellt die Beschreibung des Fehlers dar.
Error.name-Feld	Stellt den Namen dar, der den Fehler identifiziert.
Error.notImplemented-Funktion	Erstellt ein Error-Objekt, das die Sys.NotImplementedException-Ausnahme darstellt.
Error.parameterCount-Funktion	Erstellt ein Error-Objekt, das die Sys.ParameterCountException-Ausnahme darstellt.
Error.popStackFrame-Funktion	Aktualisiert die fileName-Eigenschaft und die lineNumber-Eigenschaft einer Error-Instanz, um anzugeben, an welcher Stelle der Fehler ausgelöst und nicht wo er erzeugt wurde. Verwenden Sie diese Funktion, wenn Sie benutzerdefinierte Fehlertypen erstellen.

Hinweise

Error-Erweiterungen sind Teil von Microsoft AJAX Library. Sie erweitern das integrierte Error-Objekt in JavaScript durch zusätzliche Funktionen.

Error-Typen

Die Error-Typerweiterungen generieren einen Error-Typ mit zusätzlichen Feldern, die die Ausnahmedetails darstellen. Durch alle Error-Typerweiterungen wird mindestens ein name-Feld hinzugefügt, um die Ausnahme zu identifizieren. Sie können das name-Feld der Ausnahme überprüfen, um festzustellen, welche Maßnahme erforderlich ist.

Im folgenden Beispiel wird dargestellt, wie die Error,name-Eigenschaft auf die Sys.ArgumentNullException-Ausnahme überprüft wird.

try{ } 
catch (e) {
    if (e.name === "Sys.ArgumentNullException"){
        // Code here ot handle exception.
    }
}

Weitere Informationen über das JavaScript-Objekt, das durch diesen Typ erweitert wird, finden Sie unter Error-Objekt in der Sprachreferenz.

Optimieren der Behandlung von Clientskriptfehlern für Debug- und Releasemodi

Die Erweiterungen des ASP.NET-AJAX-Objekts Error bieten zusätzliche Funktionen für die Behandlung von Clientskriptfehlern.

ASP.NET enthält Debug- und Release-Anwendungskompilierungsmodi für die Arbeit mit AJAX-Clientskripts. Dadurch können Sie Ausnahmen in Debugskripts auslösen, die hilfreich für das Debugverfahren sind, und gleichzeitig den Umfang des Releasecodes minimieren, um den Schwerpunkt auf die Leistung zu legen. Der Debugmodus stellt beispielsweise mit der Typ- und Argumentüberprüfung zusätzliche Features für die Fehlerbehandlung bereit und bietet ausführlichere Fehlermeldungen als der Releasemodus.

Weitere Informationen finden Sie unter Gewusst wie: Debuggen für ASP.NET-Anwendungen aktivieren und unter Übersicht über das Debuggen und die Ablaufverfolgung von AJAX-Anwendungen.

Beispiel

Das folgende Beispiel veranschaulicht, wie eine neue Error-Instanz durch den Aufruf der create-Methode des ASP.NET-AJAX-Objekts Error erstellt wird.

function validateNumberRange(input, min, max) 
{

    // Verify the required parameters were defined.
    if (input === undefined)
    {
        // Throw a standard exception type.
        var err = Error.argumentNull("input", "A parameter was undefined."); 
        throw err;
    }
    else if (min === undefined)
    {
        var err = Error.argumentNull("min", "A parameter was undefined."); 
        throw err;
    }
    else if (max === undefined)
    {
        var err = Error.argumentNull("max", "A parameter was undefined."); 
        throw err;
    }
    else if (min >= max)
    {
        var err = Error.invalidOperation("The min parameter must be smaller than max parameter.");
        throw err;
    }
    else if (isNaN(input))
    {
        msg = "A number was not entered.  ";
        msg += String.format("Please enter a number between {0} and {1}.", min, max);

        var err = Error.create(msg);
        throw err;
    }
    else if (input < min || input > max)
    {
        msg = "The number entered was outside the acceptable range.  ";
        msg += String.format("Please enter a number between {0} and {1}.", min, max);

        var err = Error.create(msg);
        throw err
    }

    alert("The number entered was within the acceptable range.");
}


var input = undefined;
var min = -10;
var max = 10;

// Result: A thrown ErrorArgumentNull exception with the following Error object message:
// "Sys.ArgumentNullException: A parameter was undefined. Parameter name: input"
validateNumberRange(input, min, max);

Siehe auch

Konzepte

Übersicht über das Debuggen und die Ablaufverfolgung von AJAX-Anwendungen

Referenz

Error-Objekt

new-Operator

Funktionen des Typs Error

Felder des Typs Error

Weitere Ressourcen

Sprachreferenz