CA1852: Sigillare i tipi interni

Causa

Un tipo non accessibile all'esterno dell'assembly e che non dispone di sottotipi all'interno dell'assembly contenente non viene contrassegnato sealed (NotInheritable in Visual Basic).

Descrizione regola

Quando un tipo non è accessibile all'esterno dell'assembly e non dispone di sottotipi all'interno dell'assembly contenitore, può essere sigillato in modo sicuro. I tipi di tenuta possono migliorare le prestazioni. Per altre informazioni, vedere Analyzer Proposal: Seal internal/private types(Proposta dell'analizzatore: Bloccare i tipi interni/privati).

Se si applica System.Runtime.CompilerServices.InternalsVisibleToAttribute all'assembly analizzato, questa regola non segnala i tipi non contrassegnati come sealed per impostazione predefinita, perché un campo può essere usato da un assembly amico. Per analizzare comunque l'assembly, vedere Configurare il codice da analizzare.

Come correggere le violazioni

Contrassegnare il tipo come sealed (NotInheritable in Visual Basic).

Esempio

Il frammento di codice seguente mostra una violazione di CA1852:

internal class C
{ }

Class C
End Class

Il frammento di codice seguente corregge la violazione:

internal sealed class C
{ }

NotInheritable Class C
End Class

Quando eliminare gli avvisi

È sicuro eliminare un avviso se le prestazioni non sono un problema.

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 CA1852
// The code that's violating the rule is on this line.
#pragma warning restore CA1852

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.CA1852.severity = none

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

Configurare il codice da analizzare

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

• Ignora attributo InternalsVisibleTo

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

Ignora attributo InternalsVisibleTo

Per impostazione predefinita, questa regola è disabilitata se l'assembly analizzato usa InternalsVisibleToAttribute per esporre i relativi simboli interni. È possibile impostare l'opzione ignore_internalsvisibleto per modificare la configurazione. Per specificare che la regola deve essere eseguita anche se l'assembly è contrassegnato con InternalsVisibleToAttribute, aggiungere la seguente coppia chiave-valore a un file .editorconfig nel progetto:

dotnet_code_quality.CAXXXX.ignore_internalsvisibleto = true

Questa opzione è disponibile a partire da .NET 8.