Функция Error.argumentNull

Создает объект Error, представляющий исключение Sys.ArgumentNullException.

var err = Error.argumentNull(paramName, message);

Аргументы

• paramName
  (Необязательно). Имя параметра, вызвавшего исключение (в виде строки). Если параметр paramName имеет значение null, используется сообщение по умолчанию.

• message
  (Необязательно). Строка сообщения об ошибке. Допускается значение null.

Возвращаемое значение

Объект Error, имеющий поля name и paramName, добавленные в определение типа Error.

Заметки

Функция argumentNull позволяет сообщать о появлении исключения при вызове функции или метода, а также если аргумент имеет недопустимое значение null . Параметр message позволяет указать сообщение об ошибке. Параметр paramName позволяет указать имя параметра, которому было присвоено значение null.

Пример

В следующем примере показывается, как можно создать, вызвать и зарегистрировать ошибку Sys.ArgumentNullException при помощи функции argumentNull.

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

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

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