Compartir a través de

Clase CustomError

  • Artículo

Especifica un mensaje de error personalizado de ASP.NET para un error de código de estado HTTP.

Sintaxis

class CustomError : CollectionElement

Métodos

Esta clase no contiene métodos.

Propiedades

La siguiente tabla muestra las propiedades que expone la clase CustomError.

Nombre Descripción
Redirect Un valor string de lectura y escritura obligatorio que contiene la ruta de acceso de un archivo o dirección URL que contiene un mensaje de error personalizado.
StatusCode Un valor sint32 de lectura y escritura único y necesario que especifica un código de estado de error HTTP. Los valores válidos son de 100 a 999. La propiedad de la clave.

Subclases

Esta clase no contiene subclases.

Comentarios

Las instancias de esta clase se encuentran en la propiedad CustomErrors de la clase CustomErrorsSection.

Los errores personalizados que representa la clase CustomError son específicos de ASP.NET y se encuentran en la sección <system.web> del archivo Web.config. Los errores personalizados que representa la clase HttpErrorElement son específicos de IIS 7 y se encuentran en la sección <system.webServer> del archivo ApplicationHost.config.

Ejemplo

En el ejemplo siguiente se agrega un error personalizado a la sección de errores personalizados del sitio web predeterminado.

' 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

Jerarquía de herencia

CollectionElement

CustomError

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

Clase CollectionElement
Clase CustomErrorsSection
Clase HttpErrorElement
Clase HttpErrorsSection