CA1501: Evitare ereditarietà eccessiva

Causa

Un tipo è di cinque o più livelli profondi nella gerarchia di ereditarietà.

Descrizione regola

Le gerarchie di tipi eccessivamente annidate possono essere difficili da seguire, comprendere e mantenere. Questa regola limita l'analisi alle gerarchie nello stesso modulo.

È possibile configurare questa regola nei modi seguenti:

• Per impostazione predefinita, la regola esclude i tipi dallo spazio dei nomi System. È possibile configurare la regola per escludere anche altri tipi o spazi dei nomi .
• È possibile configurare la profondità dell'albero di ereditarietà in corrispondenza della quale viene attivata questa regola.

Come correggere le violazioni

Per correggere una violazione di questa regola, derivare il tipo da un tipo di base meno profondo nella gerarchia di ereditarietà o eliminare alcuni dei tipi di base intermedi.

Quando eliminare gli avvisi

È sicuro eliminare un avviso da questa regola. Tuttavia, il codice potrebbe essere più difficile da gestire. A seconda della visibilità dei tipi di base, la risoluzione delle violazioni di questa regola potrebbe creare cambiamenti critici. Ad esempio, la rimozione dei tipi di base pubblici è una modifica che causa un'interruzione.

Eliminare un avviso

Se si vuole eliminare una singola violazione, aggiungere direttive del preprocessore al file di origine per disabilitare e quindi riabilitare la regola.

#pragma warning disable CA1501
// The code that's violating the rule is on this line.
#pragma warning restore CA1501

Per disabilitare la regola per un file, una cartella o un progetto, impostarne la gravità none su nel file di configurazione.

[*.{cs,vb}]
dotnet_diagnostic.CA1501.severity = none

Per altre informazioni, vedere Come eliminare gli avvisi di analisi del codice.

Configurare la soglia

È possibile configurare la soglia in corrispondenza della quale viene attivata questa regola.

1. Creare un file di testo denominato CodeMetricsConfig.txt.

2. Aggiungere la soglia desiderata al file di testo nel formato seguente:

   CA1501: 8
   

   In questo esempio la regola viene configurata per attivarsi quando un tipo è di otto o più livelli nella sua gerarchia di ereditarietà.

3. Nel file di progetto contrassegnare l'azione di compilazione del file di configurazione come AdditionalFiles. Ad esempio:

   <ItemGroup>
     <AdditionalFiles Include="CodeMetricsConfig.txt" />
   </ItemGroup>
   

Configurare il codice da analizzare

Usare l'opzione seguente per configurare le parti della codebase in cui eseguire questa regola.

• Nomi di tipo o spazio dei nomi esclusi dall'ereditarietà

È possibile configurare questa opzione solo per questa regola, per tutte le regole a cui si applica o per tutte le regole di questa categoria (manutenibilità) a cui si applica. Per altre informazioni, vedere Opzioni di configurazione delle regole di qualità del codice.

Nomi di tipo o spazio dei nomi esclusi dall'ereditarietà

È possibile configurare la regola per escludere determinati tipi o namespace dall'albero gerarchico di ereditarietà. Per impostazione predefinita, tutti i tipi dello System.* spazio dei nomi vengono esclusi. Indipendentemente dal valore impostato, viene aggiunto questo valore predefinito.

Esempio

L'esempio seguente mostra un tipo che viola la regola:

class BaseClass {}
class FirstDerivedClass : BaseClass {}
class SecondDerivedClass : FirstDerivedClass {}
class ThirdDerivedClass : SecondDerivedClass {}
class FourthDerivedClass : ThirdDerivedClass {}

// This class violates the rule.
class FifthDerivedClass : FourthDerivedClass {}

Imports System

Namespace ca1501

    Class BaseClass
    End Class

    Class FirstDerivedClass
        Inherits BaseClass
    End Class

    Class SecondDerivedClass
        Inherits FirstDerivedClass
    End Class

    Class ThirdDerivedClass
        Inherits SecondDerivedClass
    End Class

    Class FourthDerivedClass
        Inherits ThirdDerivedClass
    End Class

    ' This class violates the rule.
    Class FifthDerivedClass
        Inherits FourthDerivedClass
    End Class

End Namespace