CA1069: Le enumerazioni non devono avere valori duplicati

Causa

Un'enumerazione ha più membri a cui viene assegnato in modo esplicito lo stesso valore costante.

Descrizione regola

Ogni membro enum deve avere un valore costante univoco o essere assegnato in modo esplicito a un membro precedente nell'enumerazione per indicare la finalità esplicita di condivisione del valore. Ad esempio:

enum E
{
   Field1 = 1,
   AnotherNameForField1 = Field1,   // This is fine
   Field2 = 2,
   Field3 = 2,   // CA1069: This is not fine. Either assign a different constant value or 'Field2' to indicate explicit intent of sharing value.
}

Questa regola consente di rilevare i bug funzionali introdotti dagli scenari seguenti:

• Errori di digitazione accidentali, in cui l'utente ha digitato accidentalmente lo stesso valore costante per più membri.
• Copiare gli errori di incolla, in cui l'utente ha copiato una definizione di membro esistente, quindi ha rinominato il membro ma ha dimenticato di modificare il valore.
• Risoluzione di merge da più rami, in cui è stato aggiunto un nuovo membro con un nome diverso ma lo stesso valore in rami diversi.

Come correggere le violazioni

Per correggere una violazione, assegnare un nuovo valore costante univoco o assegnarlo con un membro precedente nell'enumerazione per indicare la finalità esplicita di condividere lo stesso valore. Ad esempio, il frammento di codice seguente mostra una violazione della regola e due modi per correggere la violazione:

enum E
{
   Field1 = 1,
   AnotherNameForField1 = Field1,   // This is fine
   Field2 = 2,
   Field3 = 2,   // CA1069: This is not fine. Either assign a different constant value or 'Field2' to indicate explicit intent of sharing value.
}

enum E
{
   Field1 = 1,
   AnotherNameForField1 = Field1,   // This is fine
   Field2 = 2,
   Field3 = 3,   // This is now fine
}

enum E
{
   Field1 = 1,
   AnotherNameForField1 = Field1,   // This is fine
   Field2 = 2,
   Field3 = Field2,   // This is also fine
}

Quando eliminare gli avvisi

Non eliminare le violazioni di questa regola.

Vedi anche

• Regole di progettazione