Partilhar via

customErrors elemento (esquema configurações ASP.NET)

  • Artigo

Fornece informações sobre mensagens de erro personalizadas para um aplicativo ASP.NET. The customErrors elemento pode ser definido em qualquer nível na hierarquia de arquivos do aplicativo.

<configuration> Element
  System.Web elemento (esquema configurações ASP.NET) 
    < customErrors > elemento

<customErrors defaultRedirect="url"
              mode="On|Off|RemoteOnly">
     <error. . ./>
</customErrors>

Atributos e elementos

As seções a seguir descrevem atributos, elementos filho, e elementos pai.

Atributos

Atributo

Descrição

defaultRedirect

Atributo opcional.

Especifica a URL padrão para direcionar um navegador, se ocorrer um erro. Quando esse atributo não for especificado, é exibido um erro genérico.

A URL pode ser absoluta (por exemplo, www.contoso.com/ErrorPage.htm) ou relativo. Um URL relativo, sistema autônomo /ErrorPage.htm, é relativo para o arquivo Web.config que especificou a URL para esse atributo, não para a página da Web no qual ocorreu o erro. Uma URL, iniciando com um til (~), sistema autônomo ~/ErrorPage.htm, indica que a URL especificada é relativa ao caminho raiz do aplicativo.

mode

Atributo obrigatório.

Especifica se os erros personalizados estão habilitados, desabilitado, ou mostra a clientes remoto somente para.

Esse atributo pode ser um dos seguintes valores.

Valor Descrição
On Especifica que erros personalizados estão habilitados.Se nenhum defaultRedirect atributo for especificado, os usuários verão um erro genérico. Os erros personalizados são exibidos para os clientes remoto e para o host local.
Off Especifica que erros personalizados estão desativados.Os erros ASP.NET detalhados são mostrados para os clientes remoto e para o host local.
RemoteOnly Especifica que erros personalizados são mostrados somente para clientes remoto e que os erros do ASP.NET são mostrados ao host local.Este é o valor padrão.

O padrão é RemoteOnly.

Elementos filho

Elemento

Descrição

error

Elemento opcional.

Especifica a página de erro personalizada para um determinado código de status HTTP.

A marca de erro pode aparecer várias vezes. Cada aspecto define uma condição de erro personalizadas.

Elementos pai

Elemento

Descrição

configuration

Especifica o elemento de raiz em todos os arquivos de configuração que é usado pelo Common Language Runtime e os aplicativos .NET Framework.

system.web

Especifica o elemento raiz para as definições de configuração do ASP.NET em um arquivo de configuração e contém elementos de configuração configurar aplicativos ASP.NET e o controle como os aplicativos se comportam.

Comentários

The <customErrors> elemento não se aplica a erros que ocorrem em Serviços Web XML.

Configuração padrão

O seguinte padrão customErrors elemento é configurado no arquivo computador.config no .NET estrutura versões 1.0 e 1.1.

<customErrors mode="RemoteOnly" />

Exemplo

O exemplo de configuração a seguir demonstra como especificar a utilização de um aplicativo ASP.NET páginas de manipulação de erros.

<configuration>
  <system.web>
    <customErrors defaultRedirect="GenericError.htm"
                  mode="RemoteOnly">
      <error statusCode="500"
             redirect="InternalError.htm"/>
    </customErrors>
  </system.web>
</configuration>

Informações do elemento

Manipulador de seção de configuração

System.Web.Configuration.CustomErrorsSection

Configuração de membro

SystemWebSectionGroup.CustomErrors

System.Web.Configuration.CustomErrorsMode

Locais configuráveis

Machine.config

Web.config de nível de raiz

Web.config de nível de aplicativo

Virtual ou físico diretório–nível Web.config

Requisitos

Serviços de Informações da Internet da Microsoft (IIS) versão 5.0, 5.1 ou 6.0

O .NET estrutura versão 1.0, 1.1 ou 2.0

Microsoft Visual Studio 2003 ou o Visual Studio 2005

Consulte também

Tarefas

Como: Bloquear ASP.NET Configuration Settings

Conceitos

Visão Geral da Configuração ASP.NET

Controles de Servidor Web do ASP.NET e Recursos do Navegador

Protegendo configuração ASP.NET

Cenários de configuração ASP.NET

Referência

System.Web elemento (esquema configurações ASP.NET) 

configuração elemento (Geral Settings esquema)

Erro elemento customErrors (ASP.NET Settings esquema)

System.Configuration

System.Web.Configuration

Outros recursos

Arquivos de configuração ASP.NET

Definições de configuração ASP.NET

Configurações gerais (ASP.NET)

API de Configuração do ASP.NET