Ejemplo Custom Exceptions

Artículo
10/07/2008

Actualización: noviembre 2007

Esta solución muestra dos técnicas de administración de excepciones más avanzadas: excepciones personalizadas y control global de excepciones.

Para obtener ejemplos e instrucciones para la instalación

Siga uno o varios de los procedimientos siguientes:
- En el menú Ayuda, haga clic en Ejemplos.
  
  El archivo Léame muestra información sobre los ejemplos.
- Visite el sitio web Visual Studio 2008 Samples. Están disponibles las versiones de ejemplos más recientes.
- Busque los ejemplos en el equipo en el que está instalado Visual Studio. De manera predeterminada, los ejemplos y el archivo Léame se instalan en unidad:\Archivos de programa\Microsoft Visual Studio 9.0\Samples\lcid. Para las versiones Express de Visual Studio, todos los ejemplos están en línea.

Para obtener más información, vea Localizar archivos de ejemplo.

Nota de seguridad:
En este ejemplo de código se ilustra un concepto y únicamente se muestra el código correspondiente a dicho concepto. Es posible que no cumpla los requisitos de seguridad de un entorno concreto y, por tanto, no debería utilizarse tal y como se muestra. Se recomienda agregar código de seguridad y de control de errores para que los proyectos sean más seguros y sólidos. Microsoft proporciona este ejemplo "tal cual" sin ninguna garantía.

En este ejemplo de código se ilustra un concepto y únicamente se muestra el código correspondiente a dicho concepto. Es posible que no cumpla los requisitos de seguridad de un entorno concreto y, por tanto, no debería utilizarse tal y como se muestra. Se recomienda agregar código de seguridad y de control de errores para que los proyectos sean más seguros y sólidos. Microsoft proporciona este ejemplo "tal cual" sin ninguna garantía.

Para ejecutar este ejemplo

En el Explorador de soluciones, haga clic con el botón secundario del mouse (ratón) en el proyecto Cliente y seleccione Establecer cómo proyecto de inicio.
Presione CTRL+F5. El programa se ejecuta mejor fuera del depurador para ver los efectos de un controlador global de excepciones.

Demostraciones

Este ejemplo contiene dos proyectos: un cliente de formularios Windows Forms y una biblioteca de clases.

Biblioteca de clases (servidor)

La biblioteca de clases define el Customer y un conjunto de clases de excepciones personalizadas que se utilizan para exponer errores definidos por la aplicación. Una jerarquía de herencia relaciona las clases de excepciones. La clase base es CRMSystemException, que hereda de ApplicationException. CustomerException y EmployeeException que hereda de CRMSystemException. Hay dos excepciones más que heredan de CustomerException: CustomerNotFoundException y CustomerNotDeletedException. Cada clase expone niveles diferentes de información y funcionalidad.

Código de cliente

La aplicación cliente tiene una referencia a la biblioteca de clases. Dos botones de comando ejecutan métodos en la clase Customer y detectan las excepciones personalizadas. Un tercer botón de comando genera una excepción no controlada. Además, hay una casilla con la etiqueta "Habilitar captura global de excepciones" que habilita una captura global de excepciones. Cuando está habilitado, el código definido en el método OnThreadException se ejecutará en vez del controlador de formularios Windows Forms.