Error.argumentNull 함수
업데이트: 2007년 11월
Sys.ArgumentNullException 예외를 나타내는 Error 개체를 만듭니다.
var err = Error.argumentNull(paramName, message);
인수
paramName
(선택적 요소) 예외를 발생시킨 매개 변수의 문자열 형식 이름입니다. paramName이 null인 경우에는 기본 메시지가 사용됩니다.message
(선택적 요소) 오류 메시지 문자열입니다. 값은 null이 될 수 있습니다.
반환 값
Error 형식 정의에 name 및 paramName 필드가 추가된 Error 개체입니다.
설명
argumentNull 함수를 사용하면 인수에 null 값이 지정된 메서드 또는 함수를 호출한 경우 예외가 발생했음을 알릴 수 있습니다. message 매개 변수에는 오류 메시지를 지정하고, paramName 매개 변수에는 값이 null인 매개 변수의 이름을 지정할 수 있습니다.
예제
다음 예제에서는 argumentNull 함수를 사용하여 Sys.ArgumentNullException 오류를 만들고 throw하고 catch하는 방법을 보여 줍니다.
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);