Error.argumentNull 関数
更新 : 2007 年 11 月
Sys.ArgumentNullException 例外を表す Error オブジェクトを作成します。
var err = Error.argumentNull(paramName, message);
引数
paramName
(省略可能) 例外の原因となったパラメータの名前を表す文字列。paramName が null の場合は、既定のメッセージが使用されます。message
(省略可能) エラー メッセージ文字列。値は null に設定できます。
戻り値
name フィールドおよび paramName フィールドが Error 型定義に追加された 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);