Оснастки расширений типов ошибок

Обновлен: Ноябрь 2007

Предоставляет статические функции, расширяющие встроенный тип ECMAScript (JavaScript) Error посредством включения сведений об исключении и поддержки режимов компиляции приложения (отладка или выпуск).

Пространство имен: отсутствует. Данное расширение типа является глобальным и не принадлежит к пространству имен.

Наследование: отсутствует

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

Расширения членов

Заметки

Расширения Error являются частью Microsoft AJAX (библиотека). Добавляют функции встроенного объекта JavaScript Error.

Типы ошибок

Расширения типа Error создают тип Error с дополнительными полями, представляющими сведения об исключении. Все расширения типа Error добавляют как минимум одно поле name, определяющее исключение. Сведения, содержащиеся в поле name, можно использовать для определения способа обработки исключения.

В следующем примере показана проверка свойства Error,name для исключения Sys.ArgumentNullException.

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

Дополнительные сведения об объекте JavaScript, который расширяется этим типом см. в разделе Объект "Error" в документе Справочник по языку.

Оптимизация обработки ошибок в клиентском сценарии в режимах отладки и выпуска

Расширения объекта ASP.NET AJAX Error обеспечивают дополнительные функциональные возможности по обработке ошибок в клиентском сценарии.

В ASP.NET представлены режимы компиляции приложения (отладка и выпуск) для работы с клиентскими сценариями AJAX. Это позволяет вызывать исключения в сценариях отладки, которые позволяют упростить процесс отладки, свести к минимуму размер кода выпуска и повысить производительность. В режиме отладки представлены дополнительные функции обработки ошибок, в том числе проверки типа и аргумента, а также поддерживаются более подробные сообщения об ошибках, чем в режиме выпуска.

Дополнительные сведения см. в разделах Практическое руководство. Включение отладки для приложений ASP.NET и Общие сведения об отладке и трассировке приложений AJAX.

Пример

В следующем примере показано, как создать новый экземпляр Error посредством вызова метода create объекта Error ASP.NET AJAX.

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);

См. также

Основные понятия

Общие сведения об отладке и трассировке приложений AJAX

Ссылки

Объект "Error"

Оператор new

Функции типов ошибок

Поля типов ошибок

Другие ресурсы

Справочник по языку