CA1714: Las enumeraciones Flags deberían tener nombres en plural

Artículo
06/08/2015

TypeName	FlagsEnumsShouldHavePluralNames
Identificador de comprobación	CA1714
Categoría	Microsoft.Naming
Cambio problemático	Problemático

Motivo

Una enumeración pública tiene FlagsAttribute y su nombre no termina en 's'.

Descripción de la regla

Los tipos marcados con FlagsAttribute tienen nombres en plural porque el atributo indica que se puede especificar más de un valor.Por ejemplo, una enumeración que define los días de la semana podría usarse en una aplicación en la que se pueden especificar varios días.Esta enumeración debería tener FlagsAttribute y podría denominarse 'Días'.Una enumeración similar que permite especificar sólo un día no tendría el atributo y se podría denominar 'Día'.

Las convenciones de nomenclatura proporcionan una apariencia común para las bibliotecas destinadas a Common Language Runtime.Esto reduce la curva de aprendizaje necesaria para las nuevas bibliotecas de software y aumenta la confianza del cliente respecto a que la biblioteca se haya desarrollado por parte de un especialista en desarrollo de código administrado.

Cómo corregir infracciones

Cambie el nombre de la enumeración a una palabra en plural o quite el atributo FlagsAttribute si no se deben especificar varios valores de enumeración simultáneamente.

Cuándo suprimir advertencias

Se puede suprimir una infracción de forma segura si el nombre es una palabra en plural pero no termina en 's'.Por ejemplo, si la enumeración de varios días descrita anteriormente se denominara 'DíasDeLaSemana', esto infringiría la lógica de la regla pero no su intención.Este tipo de infracciones debería suprimirse.