customErrors Element (ASP.NET Settings Schema)

[Esta documentação destina-se apenas à visualização e está sujeita a alterações em versões posteriores. Os tópicos em branco estão incluídos como espaços reservados.]

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 do aplicativo.

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

Attributes and Elements

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

Attributes

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 relativo. Uma URL relativa, como /ErrorPage.htm, é relativa ao arquivo Web. config que especificou a URL para este atributo, e não a 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 verão 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 desativados.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 que a URL para direcionar o navegador deve ser diferente do URL de solicitação da Web original. ResponseRewrite Especifica que a URL para direcionar o navegador deve ser o URL da solicitação da Web original.

Child Elements

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.

Parent Elements

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 que configurar aplicativos ASP.NET e controlar como os aplicativos se comportam.

Remarks

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>

Element Information

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 Directory–level virtuais ou físicas Web. config
Requisitos	Serviços de Informações da Internet da Microsoft (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

Tasks

How to: Lock ASP.NET Configuration Settings

Reference

System. Web Element (ASP.NET Settings Schema)

configuração Element (General Settings Schema)

Erro elemento customErrors (ASP.NET Settings Schema)

System.Configuration

System.Web.Configuration

Concepts

ASP.NET Configuration Overview

ASP.NET Server Controls and Browser Capabilities

Securing Configuration

Configuration Inheritance

Other Resources

ASP.NET Configuration Files

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

Configurações gerais (ASP.NET)

ASP.NET Configuration API