Функция 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);



Показ: