Compartir a través de

Elemento error para customErrors (Esquema de configuración de ASP.NET)

  • Artículo

Actualización: noviembre 2007

Especifica la página de error personalizada para un código de estado HTTP determinado.

Elemento <configuration>
  Elemento system.web (Esquema de configuración de ASP.NET)
    Elemento customErrors (Esquema de configuración de ASP.NET)
      Elemento error para customErrors (Esquema de configuración de ASP.NET)

<error statusCode="statuscode"
       redirect="url"/>

Atributos y elementos

En las siguientes secciones se describen los atributos, elementos secundarios y elementos primarios.

Atributos

Atributo

Descripción

statusCode

Atributo necesario.

Especifica el código de estado HTTP cuyo resultado es la redirección a la página de error.

redirect

Atributo necesario.

Dirección URL de la página personalizada que está asignada al código de error.

Elementos secundarios

Ninguno.

Elementos primarios

Elemento

Descripción

configuration

Especifica el elemento raíz requerido en cada archivo de configuración usado por Common Language Runtime y las aplicaciones .NET Framework.

system.web

Especifica el elemento raíz de la sección de configuración de ASP.NET.

customErrors

Proporciona información acerca de los mensajes de error personalizados de una aplicación de ASP.NET. Se puede definir en cualquier nivel de la jerarquía de archivos de aplicación.

Ejemplo

En el siguiente ejemplo de código de configuración se especifican las páginas de control de errores que se van a usar en una aplicación ASP.NET.

Los errores personalizados sólo se emiten para elementos administrados por ASP.NET. Por ejemplo, si consulta una página .htm que no existe, los servicios de Microsoft Internet Information Server (IIS) emiten el error estándar 404. Si en su lugar consulta una página .aspx que no existe, ASP.NET emitirá el error personalizado 404, en el caso de que haya configurado dicho error.

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

Información de elemento

Controlador de la sección de configuración

System.Web.Configuration.CustomErrorsSection

Miembro de configuración

System.Web.Configuration.CustomErrorsMode

Ubicaciones configurables

Machine.config

Web.config del nivel raíz

Web.config del nivel de aplicaciones

Web.config del nivel de directorio virtual o físico

Requisitos

Servicios de Microsoft Internet Information Server (IIS) versión 5.0, 5.1 o 6.0

.NET Framework versión 1.0, 1.1 o 2.0

Microsoft Visual Studio 2003 o Visual Studio 2005

Vea también

Tareas

Cómo: Bloquear los valores de configuración de ASP.NET

Conceptos

Información general sobre la configuración de ASP.NET

Controles de servidor Web ASP.NET y funciones del explorador

Proteger la configuración de ASP.NET

Escenarios de configuración de ASP.NET

Referencia

Elemento customErrors (Esquema de configuración de ASP.NET)

Elemento system.web (Esquema de configuración de ASP.NET)

Elemento configuration (Esquema de configuración general)

System.Configuration

System.Web.Configuration

Otros recursos

Archivos de configuración de ASP.NET

Opciones de configuración de ASP.NET

Opciones de configuración generales (ASP.NET)

API de configuración de ASP.NET