Error.argumentNull (Función)
Actualización: noviembre 2007
Crea un objeto Error que representa la excepción Sys.ArgumentNullException.
var err = Error.argumentNull(paramName, message);
Arguments
paramName
(Opcional) Nombre del parámetro en forma de cadena que provocó la excepción. Si paramName es null, se usa un mensaje predeterminado.message
(Opcional) Cadena de mensaje de error. El valor puede ser null.
Valor devuelto
Objeto Error cuyos campos name y paramName se agregaron a la definición del tipo Error.
Comentarios
La función argumentNull permite comunicar que se ha producido una excepción cuando se ha invocado una función o método y cuando un argumento tiene un valor no válido de null. El parámetro message permite especificar un mensaje de error. paramName permite especificar el nombre del parámetro cuyo valor era null.
Ejemplo
En el ejemplo siguiente se muestra cómo crear, iniciar y detectar un error Sys.ArgumentNullException mediante la función 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);
Vea también
Conceptos
Información general sobre la depuración y la traza de aplicaciones habilitadas para AJAX