Classe CustomError
Especifica uma mensagem de erro personalizada ASP.NET de um erro de código de status HTTP.
Sintaxe
class CustomError : CollectionElement
Métodos
Essa classe não contém métodos.
Propriedades
A tabela a seguir lista as propriedades expostas pela classe CustomError.
| Nome | Descrição |
|---|---|
Redirect |
Um valor string de leitura/gravação não vazio necessário que contém o caminho de um arquivo ou URL que contém uma mensagem de erro personalizada. |
StatusCode |
Um valor sint32 de leitura/gravação exclusivo necessário que especifica um código de status de erro HTTP. Os valores válidos são de 100 a 999. A propriedade de chave. |
Subclasses
Essa classe não contém subclasses.
Comentários
As instâncias desta classe estão contidas na propriedade CustomErrors da classe CustomErrorsSection.
Os erros personalizados representados pela classe CustomError são específicos para ASP.NET e estão na seção <system.web> do arquivo Web.config. Os erros personalizados representados pela classe HttpErrorElement são específicos do IIS 7 e estão na seção <system.webServer> do arquivo ApplicationHost.config.
Exemplo
O exemplo a seguir adiciona um erro personalizado à seção de erros personalizados do site da Web padrão.
' Connect to the WMI WebAdministration namespace.
Set oWebAdmin = GetObject("winmgmts:root\WebAdministration")
' Get the CustomError class object.
Set oCustomError = oWebAdmin.Get("CustomError")
' Create a new instance of the CustomError class.
Set oNewCustomError = oCustomError.SpawnInstance_
' Assign values to the StatusCode and Redirect properties.
oNewCustomError.StatusCode = 404
oNewCustomError.Redirect ="CustomPageNotFoundError.htm"
' Get the custom errors section for the default Web site.
Set oSite = oWebAdmin.Get("Site.Name='Default Web Site'")
oSite.GetSection "CustomErrorsSection", oCustomErrorsSection
' Call the CustomErrorsSection.Add method to add the custom error.
oCustomErrorsSection.Add "CustomErrors", oNewCustomError
Hierarquia de herança
CustomError
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 CollectionElement
Classe CustomErrorsSection
Classe HttpErrorElement
Classe HttpErrorsSection