Compartir a través de


Las excepciones deben ser públicas

Actualización: noviembre 2007

Nombre de tipo

ExceptionsShouldBePublic

Identificador de comprobación

CA1064

Categoría

Microsoft.Design

Cambio problemático

No problemático

Motivo

Una excepción no pública deriva directamente de System.Exception, System.SystemException o System.ApplicationException.

Descripción de la regla

Una excepción interna sólo se ve dentro de su propio ámbito interno. Cuando la excepción esté fuera del ámbito interno, sólo se podrá usar la excepción base para detectarla. Si la excepción interna se hereda de T:System.Exception, T:System.SystemException o T:System.ApplicationException, el código externo no tendrá información suficiente para saber qué hacer con la excepción.

Sin embargo, si el código tiene una excepción pública que después se utiliza como base para una excepción interna, es razonable suponer que el código que está fuera del ámbito podría hacer algo inteligente con la excepción base. La excepción pública tendrá más información que T:System.Exception, T:System.SystemException o T:System.ApplicationException.

Cómo corregir infracciones

Haga pública la excepción o derive la excepción interna de una excepción pública que no sea System.Exception, System.SystemException o System.ApplicationException.

Cuándo suprimir advertencias

Suprima un mensaje de esta regla si está seguro de que en todos los casos la excepción privada será detectada dentro de su propio ámbito interno.

Ejemplo

A continuación se muestran tres ejemplos que infringen la regla.