Error.argumentNull 函数

更新:2007 年 11 月

创建一个 Error 对象,该对象表示 Sys.ArgumentNullException 异常。

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

参数

  • paramName
    (可选)导致异常的参数的名称(表示为字符串)。如果 paramName 为 null,则使用默认消息。

  • message
    (可选)错误消息字符串。该值可以为 null。

返回值

一个 Error 对象,该对象将 nameparamName 字段添加到 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);

请参见

概念

调试和跟踪 AJAX 应用程序概述

参考

Error 类型扩展

其他资源

语言参考