Elemento customErrors (Esquema de configuración de ASP.NET)
Actualización: noviembre 2007
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.
Elemento <configuration>
Elemento system.web (Esquema de configuración de ASP.NET)
<customErrors> (Elemento)
<customErrors defaultRedirect="url"
mode="On|Off|RemoteOnly">
<error. . ./>
</customErrors>
Atributos y elementos
En las siguientes secciones se describen los atributos, elementos secundarios y elementos principales.
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.
El valor predeterminado es RemoteOnly. |
Elementos secundarios
Elemento |
Description |
|---|---|
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 |
Description |
|---|---|
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 de un archivo de configuración y contiene elementos de configuración que configuran las aplicaciones Web ASP.NET y controlan el comportamiento de las aplicaciones. |
Comentarios
El elemento <customErrors> no se aplica a los errores que se produzcan en servicios Web XML.
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 |
|
Miembro de configuración |
|
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) 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
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 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)
Otros recursos
Archivos de configuración de ASP.NET
Opciones de configuración de ASP.NET