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.