Extensões de tipo de erro

Fornece funções estáticas que estendem a ECMAScript (JavaScript) interna Erro tipo, incluindo detalhes de exceção e o suporte para modos de compilação do aplicativo (depurar ou versão).

Namespace: Nenhum. Essa extensão de tipo é global e não faz parte de um espaço para nome.

Herda: Nenhum

var err = Error.create(message, errorInfo);

Extensões de membro

Nome	Descrição
Função erro.argumento	Cria um Error objeto que representa o Sys.ArgumentException exceção.
Função erro.argumentNull	Cria um Error objeto que representa o Sys.ArgumentNullException exceção.
Função erro.argumentOutOfRange	Cria um Error objeto que representa o Sys.ArgumentOutOfRangeException exceção.
Função erro.argumentType	Cria um Error objeto que representa o Sys.ArgumentTypeException exceção.
Função erro.argumentUndefined	Cria um Error objeto que representa o Sys.ArgumentUndefinedException exceção.
Função erro.criar	Cria um Error objeto que tem informações de erro adicional opcional.
Função erro.Format	Cria um Erro objeto que representa a exceção Sys.FormatException.
Função erro.invalidOperation	Cria um Error objeto que representa o Sys.InvalidOperationException exceção.
Campo erro.mensagem	Representa a descrição do erro.
Campo erro.nome	Representa o nome que identifica o erro.
Função erro.notImplemented	Cria um Error objeto que representa o Sys.NotImplementedException exceção.
Função erro.parameterCount	Cria um Error objeto que representa o Sys.ParameterCountException exceção.
Função erro.popStackFrame	Atualiza o fileName e lineNumber Propriedades de um Error instância para indicar onde o erro foi lançado em vez de onde o erro foi criado. Use esta função, se você estiver criando tipos de erro personalizadas.

Comentários

Error as extensões são parte do Microsoft AJAX Library. Adicionam funcionalidade o JavaScript internos Error objeto.

Tipos de erro

The Error extensões de tipo de geram um Error tipo com campos adicionais que representam os detalhes da exceção. All Error extensões de tipo adicionam pelo menos um name campo para identificar a exceção. Você pode teste name campo para determinar que ação executar.

O exemplo a seguir mostra como testar o Error,name propriedade para o Sys.ArgumentNullException exceção.

try{ } 
catch (e) {
    if (e.name === "Sys.ArgumentNullException"){
        // Code here ot handle exception.
    }
}

Para obter mais informações sobre o objeto JavaScript que estende esse tipo, consulte Erro ao objeto no Referência de Idioma.

Otimização do cliente Script erro manipulação de depurar e versão modos

O ASP.NET AJAX Error objeto extensões fornecem funcionalidade de tratamento de erro de script de cliente adicionais.

O ASP.NET fornece depurar e versão modos de compilação do aplicativo para trabalhar com script de cliente AJAX. Isso permite que você lançar exceções nos scripts de depurar são úteis para o processo de depurar, minimizando o dimensionar do código da versão para enfatizar o desempenho. depurar modo fornece recursos de tratamento de erros adicionais, sistema autônomo verificação de tipo e a verificação de argumento e fornece mensagens de erro mais detalhadas que o modo de versão.

Para obter mais informações, consulte Como: Habilitar Depurando para aplicativos ASP.NET e Visão geral de Depuração e Rastreamento de Aplicativos AJAX.

Exemplo

O exemplo a seguir mostra como criar um novo Error instância invocando o create método do ASP.NET AJAX Erro objeto.

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

Erro ao objeto

novo operador

Funções do tipo de erro

Campos de tipo de erro

Outros recursos

Referência de Idioma