Compartir a través de

Elemento <customErrors>

  • Artículo

Proporciona información acerca de los mensajes de error personalizados de una aplicación de ASP.NET.

<configuration>
   <system.web>
      <customErrors>

<customErrorsdefaultRedirect="url"              mode="On|Off|RemoteOnly">   <error statusCode="statuscode"          redirect="url"/></customErrors>

Atributo requerido

Atributo Opción Descripción
Mode     Especifica si los errores personalizados están habilitados, deshabilitados o si sólo se muestran a los clientes remotos.
    On Especifica que los errores personalizados están habilitados. Si no se especifica defaultRedirect el usuario verá un error genérico.
    Off Especifica que los errores personalizados están deshabilitados. De esta forma es posible mostrar errores detallados.
    RemoteOnly Especifica que los errores personalizados sólo deben mostrarse en los clientes remotos y que los errores de ASP.NET se muestren en el host local. Éste es el valor predeterminado.

Atributo opcional

Atributo Descripción
defaultRedirect Especifica la dirección URL predeterminada a la que hay que dirigir el explorador si se produce un error. Cuando no se especifica defaultRedirect, se muestra un mensaje de error genérico. La dirección URL puede ser absoluta (por ejemplo, https://www.contoso.com/ErrorPage.htm) o relativa. Una dirección URL relativa como /ErrorPage.htm se refiere al archivo Web.config que especificó la dirección URL defaultRedirect, no a la página Web en la que se produjo el error. Una dirección URL que comience con una tilde (~), como ~/ErrorPage.htm, significa que la dirección URL especificada se refiere a la ruta de acceso raíz de la aplicación.

Subetiqueta

Subetiqueta Descripción
<error> La subetiqueta error puede aparecer varias veces. En cada ocasión define una condición de error personalizada.

Comentarios

El elemento <customErrors> no se aplica a errores que se produzcan en servicios Web XML.

Ejemplo

En el ejemplo siguiente se especifican las páginas de tratamiento de errores que deben usarse en una aplicación de ASP.NET.

<configuration>
   <system.web>
      <customErrors defaultRedirect="GenericError.htm"
                    mode="RemoteOnly">
         <error statusCode="500"
                redirect="InternalError.htm"/>
      </customErrors>
   </system.web>
</configuration>

Requisitos

Contenido dentro de: <system.web>

Plataforma Web: IIS 5.0, IIS 5.1, IIS 6.0

Archivo de configuración: Machine.config, Web.config

Controlador de la sección de configuración: System.Web.Configuration.CustomErrorsConfigHandler

Vea también

Configuración de ASP.NET | Esquema de configuración de ASP.NET