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

[Esta documentación se proporciona solo para fines preliminares y está sujeta a cambios en versiones posteriores. Se incluye temas en blanco como marcadores].

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

<customErrors defaultRedirect="url"
              mode="On|Off|RemoteOnly">
     <error. . ./>
</customErrors>

Atributos y elementos

En las próximas secciones se describen los atributos, los elementos secundarios y los elementos primarios.

Atributos

Atributo	Descripción
defaultRedirect	Atributo opcional. Especifica la dirección URL predeterminada a la que hay que dirigir un explorador si se produce un error. Cuando no se especifica este atributo, se muestra un mensaje de error genérico. La dirección URL puede ser absoluta (por ejemplo, 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 para este atributo, 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, indica que la dirección URL especificada se refiere a la ruta de acceso raíz de la aplicación.
mode	Atributo necesario. Especifica si los errores personalizados están habilitados, deshabilitados o si sólo se muestran a los clientes remotos. Este atributo puede tener uno de los siguientes valores. ValorDescripción On Especifica que los errores personalizados están habilitados.Si no se especifica el atributo defaultRedirect, los usuarios verán un error genérico.Los errores personalizados se muestran a los clientes remotos y al host local. Off Especifica que los errores personalizados están deshabilitados.Los errores detallados de ASP.NET se muestran a los clientes remotos y al host local. 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.Este es el valor predeterminado. El valor predeterminado es RemoteOnly.
redirectMode	Atributo opcional. Especifica valores para el modo en que debe administrarse la dirección URL de la solicitud original cuando se muestra una página de error personalizada. Este atributo puede tener uno de los siguientes valores. ValorDescripción ResponseRedirect Especifica que la dirección URL a la que hay que dirigir el explorador debe ser distinta de la dirección URL original de la solicitud web. ResponseRewrite Especifica que la dirección URL a la que hay que dirigir el explorador debe la dirección URL original de la solicitud web.

Elementos secundarios

Elemento	Descripción
error	Elemento opcional. Especifica la página de error personalizada para un código de estado HTTP determinado. La etiqueta error puede aparecer varias veces. En cada ocasión define una condición de error personalizada.

Elementos primarios

Elemento	Descripción
configuration	Especifica el elemento raíz de cada archivo de configuración que utilizan las aplicaciones basadas en Common Language Runtime y .NET Framework.
system.web	Especifica el elemento raíz de los valores de configuración de ASP.NET en un archivo de configuración y contiene elementos de configuración que configuran aplicaciones Web ASP.NET y controlan el comportamiento de las aplicaciones.

Comentarios

Configuración predeterminada

En la versión 1.0 y 1.1 de .NET Framework, el siguiente elemento customErrors predeterminado se configura en el archivo Machine.config.

<customErrors mode="RemoteOnly" />

Ejemplo

En el siguiente ejemplo de configuración se muestra cómo especificar las páginas de control de errores que deben usarse en una aplicación ASP.NET.

<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	SystemWebSectionGroup.CustomErrors 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	Microsoft Internet Information Services (IIS) versión 5.0, 5.1 ó 6.0 .NET Framework 1.0, 1.1 ó 2.0 Microsoft Visual Studio 2003 o Visual Studio 2005

Vea también

Tareas

How to: Lock ASP.NET Configuration Settings

Referencia

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

Elemento configuration (Esquema de configuración general)

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

System.Configuration

System.Web.Configuration

Conceptos

ASP.NET Configuration Overview

ASP.NET Server Controls and Browser Capabilities

Securing Configuration

Configuration Inheritance

Otros recursos

ASP.NET Configuration Files

Opciones de configuración de ASP.NET

Opciones de configuración generales (ASP.NET)

ASP.NET Configuration API