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