更新:2007 年 11 月
创建一个 Error 对象,该对象表示 Sys.ArgumentNullException 异常。
var err = Error.argumentNull(paramName, message);
参数
paramName
(可选)导致异常的参数的名称(表示为字符串)。如果 paramName 为 null,则使用默认消息。message
(可选)错误消息字符串。该值可以为 null。
返回值
一个 Error 对象,该对象将 name 和 paramName 字段添加到 Error 类型定义。
备注
如果使用 argumentNull 函数,则在调用函数或方法、而参数为无效值 null 时,可通知有异常发生。message 参数用于指定错误消息。paramName 用于指定值为 null 的参数的名称。
示例
下面的示例演示如何使用 argumentNull 函数来创建、引发和捕捉 Sys.ArgumentNullException 错误。
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);