Compartilhar via


Função erro.argumentNull

Cria um Erro objeto representando o Sys.ArgumentNullException exceção.

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

Argumentos

  • paramName
    (Opcional) O nome do parâmetro sistema autônomo uma seqüência de caracteres que causou a exceção. If paramName é null, uma mensagem padrão é usada.

  • message
    (Opcional) Uma seqüência de mensagem de erro. O valor pode ser null.

Valor de retorno

An Error objeto que tem name e paramName campos adicionados para o Error Digite a definição.

Comentários

The argumentNull função permite comunicar-se de que ocorreu uma exceção quando uma função ou método foi chamado e quando um argumento tiver um valor inválido de null. The message parâmetro permite especificar uma mensagem de erro. The paramName permite que você especifique o nome do parâmetro cujo valor foi null.

Exemplo

O exemplo a seguir mostra como criar, lançar e capturar um Sys.ArgumentNullException erro usando o argumentNull função.

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);

Consulte também

Conceitos

Visão geral de Depuração e Rastreamento de Aplicativos AJAX

Referência

Extensões de tipo de erro

Outros recursos

Referência de Idioma