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>