Classe CustomErrorsSection

Configura mensagens de erro personalizadas do ASP.NET.

Sintaxe

class CustomErrorsSection : ConfigurationSectionWithCollection  

Métodos

A tabela a seguir lista os métodos expostos pela classe CustomErrorsSection.

Nome	Descrição
Add	(Herdado de ConfigurationSectionWithCollection.)
Limpar	(Herdado de ConfigurationSectionWithCollection.)
Get	(Herdado de ConfigurationSectionWithCollection.)
GetAllowDefinition	(Herdado de ConfigurationSection.)
GetAllowLocation	(Herdado de ConfigurationSection.)
Remover	(Herdado de ConfigurationSectionWithCollection.)
RevertToParent	(Herdado de ConfigurationSection.)
SetAllowDefinition	(Herdado de ConfigurationSection.)
SetAllowLocation	(Herdado de ConfigurationSection.)

Propriedades

A tabela a seguir lista as propriedades expostas pela classe CustomErrorsSection.

Nome	Descrição
CustomErrors	Uma matriz de valores CustomError que especificam erros personalizados do ASP.NET.
DefaultRedirect	Um valor string de leitura/gravação obrigatório e não vazio que contém o caminho padrão de um arquivo de mensagem de erro HTTP ou a URL de uma mensagem de erro. Esse valor é herdado pela propriedade Redirect de objetos CustomError recém-criados.
Location	(Herdado de ConfigurationSection.) Uma propriedade chave.
Mode	Uma enumeração sint32 de leitura/gravação que especifica se as páginas de erro padrão ou personalizadas são mostradas localmente ou remotamente. Os valores possíveis estão listados posteriormente na seção Comentários.
Path	(Herdado de ConfigurationSection.) Uma propriedade chave.
SectionInformation	(Herdado de ConfigurationSection.)

Subclasses

Essa classe não contém subclasses.

Comentários

Os erros personalizados representados pela classe CustomErrorsSection são específicos para ASP.NET e estão na seção <system.web> do arquivo Web.config. Cada um desses erros é representado por uma instância da classe CustomError.

Os erros personalizados representados pela classe HttpErrorsSection são relacionados ao IIS 7 e estão na seção <system.webServer> do arquivo ApplicationHost.config. Cada um desses erros é representado por uma instância da classe HttpErrorElement. A integração do ASP.NET com o IIS no IIS 7 tornou essa alteração de nome necessária.

A tabela a seguir lista os possíveis valores da propriedade Mode. O padrão é 0 (RemoteOnly).

Valor	Palavra-chave	Descrição
0	RemoteOnly	A página de erro do ASP.NET padrão é mostrada aos usuários locais. Os usuários remotos receberão uma página de erro personalizada se uma for definida. Se nenhuma página de erro personalizada for definida para o erro recebido, uma página de erro do IIS será exibida.
1	On	Uma página de erro personalizada do ASP.NET definida pelo usuário é mostrada para usuários locais e remotos.
2	Off	A página de erro do ASP.NET padrão é mostrada para usuários locais e remotos.

Exemplo

O exemplo a seguir define a propriedade DefaultRedirect como "CustomError.htm" e a propriedade Mode como On.

' Connect to the WMI WebAdministration namespace.  
Set oWebAdmin = GetObject("winmgmts:root\WebAdministration")  
  
' Get the custom errors section for the default Web site.  
Set oSite = oWebAdmin.Get("Site.Name='Default Web Site'")  
oSite.GetSection "CustomErrorsSection", oSection  
  
' Set the default redirect page to CustomError.htm,  
' and set the Mode property to On.  
oSection.DefaultRedirect = "CustomError.htm"  
oSection.Mode = 1  
oSection.Put_  
  

Hierarquia de herança

ConfigurationSection

ConfigurationSectionWithCollection

CustomErrorsSection

Requisitos

Tipo	Descrição
Cliente	– IIS 7.0 no Windows Vista – IIS 7.5 no Windows 7 – IIS 8.0 no Windows 8 – IIS 10.0 no Windows 10
Servidor	– IIS 7.0 no Windows Server 2008 – IIS 7.5 no Windows Server 2008 R2 – IIS 8.0 no Windows Server 2012 – IIS 8.5 no Windows Server 2012 R2 – IIS 10.0 no Windows Server 2016
Product	– IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0
Arquivo MOF	WebAdministration.mof

Confira também

Classe ConfigurationSectionWithCollection
Classe CustomError
Classe HttpErrorElement
Classe HttpErrorsSection