Objeto Error

Artigo
08/01/2011

Contém informações sobre erros. Existem duas formas do Error construtor.

function Error([description : String ])
function Error([number : Number [, description : String ]])

Argumentos

number
Opcional. Valor numérico atribuído a erro, especificando o valor da número propriedade. Se omitido de zero.
description
Opcional. Breve seqüência de caracteres que descreve o erro, especificando o valor inicial do Descrição e mensagem propriedades. Seqüência de caracteres vazia se omitido.

Comentários

Errorobjetos podem ser criados explicitamente usando o construtor mostrado acima. Você pode adicionar propriedades para o Error o objeto para expandir seus recursos. Um Error objeto também é criado sempre que um erro em tempo de execução ocorre descrever o erro.

Normalmente, um objeto Error é lançado com o throw declaração e a expectativa de que ele será identificado por um instrução try catch instrução. Você pode usar um throw a instrução para passar a qualquer tipo de dados como um erro; o throw declaração não irá criar implicitamente uma Error objeto. No entanto, lançando uma Error o objeto, um catch bloco pode tratar erros de tempo de execução de JScript e definido pelo usuário da mesma forma.

O Error objeto tem quatro propriedades intrínsecas: a descrição do erro (Descrição e mensagem propriedades), o número do erro (número propriedade) e o nome do erro (nome propriedade). O Descrição e mensagem propriedades se referem a mesma mensagem; o Descrição propriedade retroativamente fornece compatibilidade, enquanto o mensagem propriedade é compatível com o padrão ECMA.

Um número de erro é um valor de 32 bits. A palavra de 16 bits superior é o código de recurso, enquanto a palavra inferior é o código de erro real. Para ler a desativar o código de erro real, use o e (bit a bit E) operador para combinar a propriedade de número com o número hexadecimal 0xFFFF.

Aviso

Tentando usar o JScript Error de objeto em um ASP.NET página de produto pode ser resultados não intencionais. Isso resulta de potencial de ambigüidade entre o JScript Error objeto e o Error o evento da ASP.NET página. Use o System. Exception de classe em vez da Error objeto para manipulação de erros no ASP.NET páginas.

Observação
Somente JScript fornece a Error objeto. Desde que ele não é derivado de um .NET Framework digitar, outra especificação de CLS (Common Language) idiomas não é possível usá-lo. Conseqüentemente, quando o tipo-anotando os parâmetros e tipos de retorno dos métodos compatíveis com CLS, certifique-se de usar o System. Exception o tipo de dados em vez da Error objeto. Entretanto, você pode usar o Error objeto digitar anotar identificadores diferente de parâmetros ou tipos de retorno. Para obter mais informações, consulte Escrevendo código compatível com CLS.

Somente JScript fornece a Error objeto. Desde que ele não é derivado de um .NET Framework digitar, outra especificação de CLS (Common Language) idiomas não é possível usá-lo. Conseqüentemente, quando o tipo-anotando os parâmetros e tipos de retorno dos métodos compatíveis com CLS, certifique-se de usar o System. Exception o tipo de dados em vez da Error objeto. Entretanto, você pode usar o Error objeto digitar anotar identificadores diferente de parâmetros ou tipos de retorno. Para obter mais informações, consulte Escrevendo código compatível com CLS.

Exemplo

O exemplo a seguir ilustra um uso o Error objeto.

try {
   // Throw an error.
   throw new Error(42,"No question");
} catch(e) {
   print(e)
// Extract the error code from the error number.
   print(e.number & 0xFFFF)
   print(e.description)
}

A saída desse código é: