Errores personalizados (Ficha), Valores de configuración de ASP.NET (Cuadro de diálogo)

Actualización: noviembre 2007

Cuando ocurre un error en una página Web o componente de ASP.NET, ASP.NET genera un código de error. Los errores pueden ser del siguiente tipo:

• En tiempo de compilación.

• Analizador (elementos ASP.NET con formato incorrecto).

• Configuración

• En tiempo de ejecución.

  Nota

  El complemento MMC para ASP.NET funciona con IIS 6.0 o anterior. La herramienta de administración de IIS 7.0 incluye la funcionalidad de la herramienta MMC de ASP.NET. Para obtener más información, vea Configuración de ASP.NET e IIS.

De forma predeterminada, ASP.NET genera dinámicamente una página de error que contiene una descripción del error, el nombre de la página en la que ocurrió el error y un seguimiento de la pila. Si está habilitado el modo de depuración, la página generada dinámicamente también incluye un fragmento del código fuente donde se originó el error. Definiendo errores personalizados, se puede especificar cómo la aplicación Web responde cuando se produce un error.

Para mostrar la ficha Errores personalizados del cuadro de diálogo Valores de configuración de ASP.NET

1. En Microsoft Windows, abra Herramientas administrativas y, a continuación, haga clic en Administrador de Internet Information Services (IIS).

   Aparece el Administrador de IIS.

2. En Internet Information Services, expanda nombreDeServidor(equipo local), expanda Sitios Web, haga clic con el botón secundario del mouse en Websitename o Sitio Web predeterminado y, a continuación, haga clic en Propiedades.

   Aparece el cuadro de diálogo Propiedades del sitio Web.

3. Haga clic en la ficha ASP.NET y, a continuación, en Editar configuración.

   Aparece el cuadro de diálogo Valores de configuración de ASP.NET.

4. Haga clic en la ficha Errores personalizados.

Tareas

La ficha Errores personalizados permite realizar las tareas siguientes:

• Especificar una página de error predeterminada que se muestre cuando ocurra un error de ASP.NET en cualquier parte de la aplicación Web.

• Asignar códigos de error HTTP específicos a las páginas de error correspondientes.

  Nota

  Las asignaciones sólo funcionan para los errores que se notifican a ASP.NET. Por ejemplo, a ASP.NET no se le informa de manera predeterminada de los errores HTTP 404 (no se ha encontrado la página). Si desea que ASP.NET reciba estos errores, puede establecer las propiedades del sitio Web de modo que se asignen los errores HTTP a páginas .aspx.

• Especificar si las páginas de error personalizadas se muestran para todos los usuarios, ningún usuario o usuarios remotos (no administrativos).

Elementos de interfaz de usuario

• Modo de error personalizado
  Haga clic en un modo para especificar cómo se van a mostrar los errores personalizados:

  • Activado   

    Las páginas de errores personalizados siempre se muestran. Utilice este valor de configuración para ver los errores durante el desarrollo de la aplicación Web.

  • Desactivado   

    Las páginas de errores personalizados no se muestran. En su lugar, los errores producen una página de error de ASP.NET generada dinámicamente.

  • Sólo remoto   

    Los errores sólo se redirigen para las solicitudes que no se originan localmente en el servidor Web. Utilice este modo para ver los errores de ASP.NET mientras trabaja en el servidor, pero mostrar los errores personalizados a los usuarios de la aplicación Web.

• URL de redirección predeterminada
  Especifique el nombre de la página (.aspx o .htm) que se va a mostrar en respuesta a los errores no controlados en cualquier parte de la aplicación Web.

• Errores personalizados heredados
  Muestra las páginas de los errores personalizados heredados de los archivos de configuración ubicados en un nivel superior de la jerarquía. Puede reemplazar la configuración de error heredada agregando un error personalizado local para el código de estado que desee reemplazar.

• Errores personalizados locales
  Muestra específicamente las páginas de error del actual sitio Web.

• Agregar
  Haga clic en esta opción para abrir el cuadro de diálogo Agregar o editar controladores de errores personalizados donde puede especificar un código de error HTTP y la página que se va a mostrar cuando ASP.NET detecte el error.

  Nota

  Las asignaciones sólo funcionan para los errores que se notifican a ASP.NET. Por ejemplo, a ASP.NET no se le informa de manera predeterminada de los errores HTTP 404 (no se ha encontrado la página). Si desea que ASP.NET reciba estos errores, puede establecer las propiedades del sitio Web de modo que se asignen los errores HTTP a páginas .aspx.

  Debe proporcionar el código de error HTTP y la dirección URL de la página a la que se asigna. La página a la que se hace referencia no tiene que estar en el sitio Web actual.

  Nota

  El Administrador de IIS no valida la dirección URL especificada.

• Editar
  Haga clic en esta opción para abrir el cuadro de diálogo Agregar o editar controladores de errores personalizados donde puede cambiar el nombre de página o el código de error para la página seleccionada en Errores personalizados locales.

• Quitar
  Haga clic para eliminar una asignación de la página de error.

Vea también

Tareas

Cómo: Tener acceso a las opciones de configuración de ASP.NET mediante programación

Conceptos

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

Referencia

Aplicación (Ficha), Valores de configuración de ASP.NET (Cuadro de diálogo)

Autorización (Ficha), Valores de configuración de ASP.NET (Cuadro de diálogo)

Ubicaciones (Ficha), Valores de configuración ASP.NET (Cuadro de diálogo)

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

Elemento appSettings (Esquema de configuración general)