Partilhar via


Erro elemento customErrors (ASP.NET Settings esquema)

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

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

<error statusCode="statuscode"
       redirect="url"/>

Atributos e elementos

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

Atributos

Atributo

Descrição

statusCode

Atributo obrigatório.

Especifica o código de status HTTP que resultados no redirecionamento para a página de erro.

redirect

Atributo obrigatório.

A URL da página personalizada que é mapeada para o código de erro.

Elementos filho

Nenhum.

Elementos pai

Elemento

Descrição

configuration

Especifica o elemento raiz exigido em todos os arquivos de configuração usado pelo common linguagem tempo de execução e os aplicativos do .NET estrutura.

system.web

Especifica o elemento raiz referente à seção de configuração do ASP.NET.

customErrors

Fornece informações sobre mensagens de erro personalizadas para um aplicativo ASP.NET. Podem ser definido em qualquer nível no aplicativo arquivo hierarquia.

Exemplo

O seguinte exemplo de código de configuração especifica a utilização de um aplicativo ASP.NET páginas de manipulação de erros.

Somente os erros personalizados são emitidos para os elementos que são manipulados pelo ASP.NET. Por exemplo, se você fizer referência a uma página .htm não existente, o Serviços de Informações da Internet da Microsoft (IIS) emite o erro 404 padrão. Se você consultar a uma página .aspx não existente em vez disso, o ASP.NET emite o erro 404 personalizadas, se você tiver configurado o erro.

<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

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

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

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

configuração elemento (Geral 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