Classe HttpErrorElement
Configura a resposta de um erro HTTP específico.
Sintaxe
class HttpErrorElement : CollectionElement
Métodos
Essa classe não contém métodos.
Propriedades
A tabela a seguir lista as propriedades expostas pela classe HttpErrorElement.
| Nome | Descrição |
|---|---|
Path |
Um valor string de leitura/gravação necessário que contém o nome do arquivo ou a URL que é atendida em resposta ao erro HTTP especificado pelas propriedades StatusCode e SubStatusCode. |
PrefixLanguageFilePath |
Um valor string de leitura/gravação opcional que especifica o caminho físico de um diretório de página de erro personalizado. O diretório de página de erro personalizado contém um ou mais subdiretórios específicos a um idioma com páginas de erro personalizadas para o erro especificado na propriedade StatusCode.O caminho do arquivo é criado da seguinte maneira: PrefixLanguageFilePath\ClientLanguageID\CustomErrorPageFile. Por exemplo, PrefixLanguageFilePath pode ser "%SystemDrive%\inetpub\custerr", ClientLanguageID pode ser "en-us" e CustomErrorPageFile (especificado pela propriedade Path) pode ser "401.htm". Observação: erros personalizados são específicos a um idioma e normalmente retornam o erro personalizado no idioma do sistema do cliente. Para que uma página de erro seja retornada em um idioma diferente do idioma do sistema do cliente, o pacote de idiomas para esse idioma deve ser instalado no cliente. Por exemplo, se PrefixLanguageFilePath for "d:\inetpub\custerr" e o cliente tiver o pacote de idiomas en-US instalado, o caminho resultante para o código de erro 404 será d:\inetpub\custerr\en-us\404.htm quando o navegador cliente enviar "en-us" no cabeçalho Accept-Language. No entanto, se ja-JP for o idioma do sistema e o pacote de idiomas en-US não estiver instalado, o caminho resultante será d:\inetpub\custerr\ja-jp\404.htm. |
ResponseMode |
Um valor sint32 de leitura/gravação necessário que especifica a resposta ao erro HTTP especificado por StatusCode e SubStatusCode. Os valores possíveis estão listados posteriormente na seção Comentários. |
StatusCode |
Um valor uint32 de leitura/gravação exclusivo necessário que contém um código de status de 400 a 999. Uma propriedade chave. |
SubStatusCode |
Um valor sint32 de leitura/gravação exclusivo necessário que contém um código de substatus de –1 a 999. O padrão é –1. Uma propriedade chave. |
Subclasses
Essa classe não contém subclasses.
Comentários
As instâncias dessa classe estão contidas na propriedade da matriz HttpErrors da classe HttpErrorsSection.
Essa classe representa um elemento <error> na seção <httpErrors> do arquivo ApplicationHost.config.
A tabela a seguir contém os possíveis valores e palavras-chave da propriedade ResponseMode. O padrão é 0 (File).
| Valor | Palavra-chave | Descrição |
|---|---|---|
| 0 | File |
O servidor Web retorna a página da Web especificada na propriedade Path. |
| 1 | ExecuteURL |
O servidor Web retorna a página ASP especificada em Path. |
| 2 | Redirect |
O servidor Web redireciona a solicitação para a URL especificada em Path. |
Hierarquia de herança
HttpErrorElement
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 HttpErrorsSection
Configurando mensagens de erro personalizadas
Códigos de Status do IIS