HttpErrorElement (clase)
Configura la respuesta a un error HTTP específico.
Sintaxis
class HttpErrorElement : CollectionElement
Métodos
Esta clase no contiene métodos.
Propiedades
La siguiente tabla muestra las propiedades que expone la clase HttpErrorElement.
| Nombre | Descripción |
|---|---|
Path |
Valor string de lectura y escritura necesario que contiene el nombre de archivo o la dirección URL que se proporciona en respuesta al error HTTP especificado por las propiedades StatusCode y SubStatusCode. |
PrefixLanguageFilePath |
Valor string opcional de lectura y escritura que especifica la ruta de acceso física de un directorio de página de error personalizado. El directorio de página de error personalizado contiene uno o varios subdirectorios específicos del idioma con páginas de error personalizadas para el error especificado en la propiedad StatusCode.La ruta de acceso del archivo se construye de la siguiente manera: PrefixLanguageFilePath\ClientLanguageID\CustomErrorPageFile. Por ejemplo, PrefixLanguageFilePath podría ser "%SystemDrive%\inetpub\custerr", ClientLanguageID podría ser "en-us" y CustomErrorPageFile (especificado por la propiedad Path) podría ser "401.htm". Nota: Los errores personalizados son específicos del idioma y normalmente devuelven el error personalizado en el idioma del sistema del cliente. Para que se devuelva una página de error en un idioma diferente del idioma del sistema del cliente, el paquete de idioma de ese idioma debe instalarse en el cliente. Por ejemplo, si PrefixLanguageFilePath es "d:\inetpub\custerr" y el cliente tiene instalado el paquete de idioma en-US, la ruta de acceso resultante para el código de error 404 es d:\inetpub\custerr\en-us\404.htm cuando el explorador cliente envía "en-us" en el encabezado Accept-Language. Sin embargo, si ja-JP es el idioma del sistema, y el paquete de idioma en-US no está instalado, la ruta de acceso resultante es d:\inetpub\custerr\ja-jp\404.htm. |
ResponseMode |
Valor sint32 de lectura y escritura necesario que especifica la respuesta al error HTTP especificado por StatusCode y SubStatusCode. Los valores posibles se enumeran más adelante en la sección Comentarios. |
StatusCode |
Valor uint32 de lectura y escritura único necesario que contiene un código de estado de 400 a 999. Una propiedad clave. |
SubStatusCode |
Valor sint32 de lectura y escritura único necesario que contiene un código de subestado de –1 a 999. El valor predeterminado es –1. Una propiedad clave. |
Subclases
Esta clase no contiene subclases.
Comentarios
Las instancias de esta clase se encuentran en la propiedad de matriz HttpErrors de la clase HttpErrorsSection.
Esta clase representa un elemento <error> en la sección <httpErrors> del archivo ApplicationHost.config.
La tabla siguiente contiene los valores y las palabras clave posibles de la propiedad ResponseMode. El valor predeterminado es 0 (File).
| Valor | Palabra clave | Descripción |
|---|---|---|
| 0 | File |
El servidor web devuelve la página web especificada en la propiedad Path. |
| 1 | ExecuteURL |
El servidor web devuelve la página ASP especificada en Path. |
| 2 | Redirect |
El servidor web redirige la solicitud a la dirección URL especificada en Path. |
Jerarquía de herencia
HttpErrorElement
Requisitos
| Tipo | Descripción |
|---|---|
| Remoto | - IIS 7.0 en Windows Vista - IIS 7.5 en Windows 7 - IIS 8.0 en Windows 8 - IIS 10.0 en Windows 10 |
| Server | - IIS 7.0 en Windows Server 2008 - IIS 7.5 en Windows Server 2008 R2 - IIS 8.0 en Windows Server 2012 - IIS 8.5 en Windows Server 2012 R2 - IIS 10.0 en Windows Server 2016 |
| Producto | - IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0 |
| Archivo MOF | WebAdministration.mof |
Consulte también
CollectionElement (clase)
HttpErrorsSection (clase)
Configuración de mensajes de error personalizados
Códigos de estado de IIS