CustomErrorsSection (clase)
Configura mensajes de error personalizados de ASP.NET.
Sintaxis
class CustomErrorsSection : ConfigurationSectionWithCollection
Métodos
La siguiente tabla muestra los métodos expuestos por la clase CustomErrorsSection.
| Nombre | Descripción |
|---|---|
| Add (Agregar) | (Se hereda de ConfigurationSectionWithCollection). |
| Borrar | (Se hereda de ConfigurationSectionWithCollection). |
| Get | (Se hereda de ConfigurationSectionWithCollection). |
| GetAllowDefinition | (Se hereda de ConfigurationSection). |
| GetAllowLocation | (Se hereda de ConfigurationSection). |
| Remove | (Se hereda de ConfigurationSectionWithCollection). |
| RevertToParent | (Se hereda de ConfigurationSection). |
| SetAllowDefinition | (Se hereda de ConfigurationSection). |
| SetAllowLocation | (Se hereda de ConfigurationSection). |
Propiedades
La siguiente tabla muestra las propiedades expuestas por la clase CustomErrorsSection.
| Nombre | Descripción |
|---|---|
CustomErrors |
Matriz de valores CustomError que especifican errores personalizados de ASP.NET. |
DefaultRedirect |
Valor string de lectura y escritura obligatorio y no vacío que contiene la ruta de acceso predeterminada de un archivo de mensaje de error HTTP o la dirección URL de un mensaje de error. Este valor lo hereda la propiedad Redirect de los objetos CustomError recién creados. |
Location |
(Se hereda de ConfigurationSection). Una propiedad clave. |
Mode |
Enumeración sint32 de lectura y escritura que especifica si las páginas de error personalizadas o predeterminadas se muestran local o remotamente. Los valores posibles se enumeran más adelante en la sección Comentarios. |
Path |
(Se hereda de ConfigurationSection). Una propiedad clave. |
SectionInformation |
(Se hereda de ConfigurationSection). |
Subclases
Esta clase no contiene subclases.
Comentarios
Los errores personalizados representados por la clase CustomErrorsSection son específicos de ASP.NET y se encuentran en la sección <system.web> del archivo Web.config. Cada uno de estos errores se representa mediante una instancia de la clase CustomError.
Los errores personalizados representados por la clase HttpErrorsSection están relacionados con IIS 7 y se encuentran en la sección <system.webServer> del archivo ApplicationHost.config. Cada uno de estos errores se representa mediante una instancia de la clase HttpErrorElement. La integración de ASP.NET con IIS en IIS 7 hizo necesario este cambio de nombre.
En la siguiente tabla se describen los posibles valores de la propiedad Mode. El valor predeterminado es 0 (RemoteOnly).
| Valor | Palabra clave | Descripción |
|---|---|---|
| 0 | RemoteOnly |
La página de error predeterminada de ASP.NET se muestra a los usuarios locales. Los usuarios remotos recibirán una página de error personalizada si se define una. Si no se define ninguna página de error personalizada para el error recibido, se muestra una página de error de IIS. |
| 1 | On |
Se muestra una página de error personalizada de ASP.NET definida por el usuario para usuarios locales y remotos. |
| 2 | Off |
La página de error predeterminada de ASP.NET se muestra para los usuarios locales y remotos. |
Ejemplo
En el ejemplo siguiente se establece la propiedad DefaultRedirect en "CustomError.htm" y la propiedad Mode en 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_
Jerarquía de herencia
ConfigurationSectionWithCollection
CustomErrorsSection
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
ConfigurationSectionWithCollection (clase)
CustomError (clase)
HttpErrorElement (clase)
HttpErrorsSection (clase)