Compartilhar via


customErrors Element (ASP.NET Settings Schema)

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

<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 o 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 relativa. Uma URL relativa, como /ErrorPage.htm, é relativo ao arquivo Web. config que especificou a URL para este atributo, e não à página da Web no qual ocorreu o erro. Uma URL iniciada com um til (~), como ~/ErrorPage.htm, indica que a URL especificada é relativo ao caminho raiz do aplicativo.

mode

Atributo obrigatório.

Especifica se os erros personalizados estão habilitados, desabilitados ou serão mostrados somente para clientes remotos.

Esse atributo pode ser um dos seguintes valores.

ValorDescrição
On Especifica que erros personalizados estão habilitados.Se nenhum defaultRedirect atributo for especificado, os usuários vêem um erro genérico.Os erros personalizados são mostrados para os clientes remotos e o host local.
Off Especifica que erros personalizados estão desabilitados.O ASP detalhado.NET são exibidos para os clientes remotos e o host local.
RemoteOnly Especifica que erros personalizados são mostrados somente para clientes remotos e que o ASP.NET são exibidos ao host local.Este é o valor padrão.

O padrão é RemoteOnly.

redirectMode

Atributo opcional.

Especifica valores para como o URL da solicitação original é tratado quando uma página de erro personalizada é exibida.

Esse atributo pode ser um dos seguintes valores.

ValorDescrição
ResponseRedirect Especifica a URL para direcionar o navegador deve ser diferente da URL de solicitação da Web original.
ResponseRewrite Especifica que a URL para direcionar o navegador deve ser a URL de solicitação da Web original.

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 ocorrência 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 o ASP.Definições de configuração de rede em uma configuração de arquivo e contém elementos de configuração para configurar aplicativos ASP.NET e controlar como os aplicativos se comportam.

Comentários

Configuração padrão

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

<customErrors mode="RemoteOnly" />

Exemplo

O exemplo de configuração a seguir demonstra como especificar as páginas a serem usadas para uma página ASP de manipulação de erros.NET Visual Basic.

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

Informações do elemento

Manipulador da seção de configuração

System.Web.Configuration.CustomErrorsSection

Membro de configuração

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ísica directory–level Web. config

Requisitos

De da (IIS) versão 5.0, 5.1 ou 6.0

A.NET Framework versão 1.0, 1.1 ou 2.0

Microsoft Visual Studio 2003 ou 2005 de Visual Studio

Consulte também

Tarefas

Como: Bloquear definições de configuração ASP.NET

Referência

system.web Element (ASP.NET Settings Schema)

configuração Element (Geral Configurações Schema)

erro Elemento customErrors (ASP.NET Configurações Schema)

System.Configuration

System.Web.Configuration

Conceitos

Visão geral da configuração ASP.NET

Controles de servidor Web do ASP.NET e recursos do navegador

Protegendo a configuração do ASP.NET

Cenários de configuração ASP.NET

Outros recursos

Arquivos de configuração ASP.NET

ASP.NET Configuration Settings

General Configuration Settings (ASP.NET)

API de Configuração do ASP.NET