CA1852: Sigillare i tipi interni
| Proprietà | valore |
|---|---|
| ID regola | CA1852 |
| Title | Tipi interni di tenuta |
| Categoria | Prestazioni |
| La correzione causa un'interruzione o meno | Non causa un'interruzione |
| Versione introdotta | .NET 7 |
| Abilitato per impostazione predefinita in .NET 9 | No |
Causa
Un tipo non accessibile all'esterno dell'assembly e non dispone di sottotipi all'interno dell'assembly contenitore non è 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 bloccato 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 contrassegna i tipi che non sono contrassegnati come per sealed impostazione predefinita, perché un campo può essere usato da un assembly Friend. 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.
È 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. Per specificare che la regola deve essere eseguita anche se l'assembly è contrassegnato con InternalsVisibleToAttribute, aggiungere la coppia chiave-valore seguente a un file con estensione editorconfig nel progetto:
dotnet_code_quality.CAXXXX.ignore_internalsvisibleto = true
Questa opzione è disponibile a partire da .NET 8.
