Condividi tramite


Categorie di regole

Ogni regola di analisi del codice appartiene a una categoria di regole. Ad esempio, le regole di progettazione supportano la conformità alle linee guida di progettazione .NET e le regole di sicurezza consentono di prevenire i difetti di sicurezza. È possibile configurare il livello di gravità per un'intera categoria di regole. È anche possibile configurare opzioni aggiuntive in base alla categoria.

La tabella seguente illustra le diverse categorie di regole di analisi del codice e fornisce un collegamento alle regole in ciascuna categoria. Elenca inoltre il valore di configurazione da usare in un file EditorConfig per configurare in blocco il livello di gravità della regola in base alla categoria. Ad esempio, per impostare il livello di gravità delle violazioni delle regole di sicurezza come errori, la voce EditorConfig è dotnet_analyzer_diagnostic.category-Security.severity = error.

Suggerimento

L'impostazione del livello di gravità per una categoria di regole tramite la sintassi dotnet_analyzer_diagnostic.category-<category>.severity non si applica alle regole disabilitate per impostazione predefinita. Tuttavia, a partire da .NET 6, è possibile usare la proprietà del progetto AnalysisMode< Category> per abilitare tutte le regole in una categoria.

Regole di progettazione

Valore
Collegamento alle regole Regole di progettazione
Descrizione Le regole di progettazione supportano la conformità alle linee guida per la progettazione di Framework.
Valore EditorConfig dotnet_analyzer_diagnostic.category-Design.severity
Valore della proprietà MSBuild <AnalysisModeDesign>

Regole della documentazione

Valore
Collegamento alle regole Regole della documentazione
Descrizione Le regole della documentazione supportano la scrittura di librerie ben documentate tramite l'uso corretto dei commenti della documentazione XML per le API visibili esternamente.
Valore EditorConfig dotnet_analyzer_diagnostic.category-Documentation.severity
Valore della proprietà MSBuild <AnalysisModeDocumentation>

Regole di globalizzazione

Valore
Collegamento alle regole Regole di globalizzazione
Descrizione Le regole di globalizzazione supportano applicazioni e librerie internazionalizzate.
Valore EditorConfig dotnet_analyzer_diagnostic.category-Globalization.severity
Valore della proprietà MSBuild <AnalysisModeGlobalization>

Regole di portabilità e interoperabilità

Valore
Collegamento alle regole Regole di portabilità e interoperabilità
Descrizione Le regole di portabilità supportano la portabilità tra piattaforme diverse. Le regole di interoperabilità supportano l'interazione con i client COM.
Valore EditorConfig dotnet_analyzer_diagnostic.category-Interoperability.severity
Valore della proprietà MSBuild <AnalysisModeInteroperability>

Regole di manutenibilità

Valore
Collegamento alle regole Regole di manutenibilità
Descrizione Le regole di gestibilità supportano la manutenzione di librerie e applicazioni.
Valore EditorConfig dotnet_analyzer_diagnostic.category-Maintainability.severity
Valore della proprietà MSBuild <AnalysisModeMaintainability>

Regole di denominazione

Valore
Collegamento alle regole Regole di denominazione
Descrizione Le regole di denominazione supportano la conformità alle convenzioni di denominazione delle linee guida di progettazione di .NET.
Valore EditorConfig dotnet_analyzer_diagnostic.category-Naming.severity
Valore della proprietà MSBuild <AnalysisModeNaming>

Regole di prestazioni

Valore
Collegamento alle regole Regole di prestazioni
Descrizione Le regole di prestazioni supportano applicazioni e librerie ad alte prestazioni.
Valore EditorConfig dotnet_analyzer_diagnostic.category-Performance.severity
Valore della proprietà MSBuild <AnalysisModePerformance>

Regole SingleFile

Valore
Collegamento alle regole Regole SingleFile
Descrizione Le regole a file singolo supportano applicazioni a file singolo.
Valore EditorConfig dotnet_analyzer_diagnostic.category-SingleFile.severity
Valore della proprietà MSBuild <AnalysisModeSingleFile>

Regole di affidabilità

Valore
Collegamento alle regole Regole di affidabilità
Descrizione Le regole di affidabilità supportano l'affidabilità di applicazioni e librerie, ad esempio il corretto utilizzo di memoria e thread.
Valore EditorConfig dotnet_analyzer_diagnostic.category-Reliability.severity
Valore della proprietà MSBuild <AnalysisModeReliability>

Regole di sicurezza

Valore
Collegamento alle regole Regole di sicurezza
Descrizione Le regole di sicurezza supportano librerie e applicazioni più sicure. Queste regole contribuiscono ad evitare che il programma presenti difetti nella sicurezza.
Valore EditorConfig dotnet_analyzer_diagnostic.category-Security.severity
Valore della proprietà MSBuild <AnalysisModeSecurity>

Regole di stile

Valore
Collegamento alle regole Regole di stile
Descrizione Le regole di stile supportano uno stile di codice coerente nella codebase. Queste regole iniziano con il prefisso "IDE".*
Valore EditorConfig dotnet_analyzer_diagnostic.category-Style.severity
Valore della proprietà MSBuild <AnalysisModeStyle>

* Usare il valore EditorConfig dotnet_analyzer_diagnostic.category-CodeQuality.severity per abilitare le regole seguenti: IDE0051, IDE0052, IDE0064 e IDE0076. Sebbene queste regole inizino con il prefisso "IDE", esse non fanno tecnicamente parte della categoria Style.

Regole di utilizzo

Valore
Collegamento alle regole Regole di utilizzo
Descrizione Le regole di utilizzo supportano l'uso corretto di .NET.
Valore EditorConfig dotnet_analyzer_diagnostic.category-Usage.severity
Valore della proprietà MSBuild <AnalysisModeUsage>