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 per categoria.
La tabella seguente illustra le diverse categorie di regole di analisi del codice e fornisce un collegamento alle regole in ogni categoria. Elenca anche il valore di configurazione da usare in un file EditorConfig per configurare in blocco la gravità della regola in base alla categoria. Ad esempio, per impostare la gravità delle violazioni delle regole di sicurezza come errori, la voce EditorConfig è dotnet_analyzer_diagnostic.category-Security.severity = error.
Suggerimento
L'impostazione della gravità per una categoria di regole tramite la dotnet_analyzer_diagnostic.category-<category>.severity sintassi 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
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 librerie e applicazioni pronte per il mondo. |
|
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 per la progettazione .NET. |
|
Valore EditorConfig |
dotnet_analyzer_diagnostic.category-Naming.severity |
|
Valore della proprietà MSBuild |
<AnalysisModeNaming> |
|
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 di 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 la libreria e l'affidabilità delle applicazioni, ad esempio l'utilizzo corretto della memoria e del 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 consentono di prevenire i difetti di sicurezza nel programma. |
|
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 dotnet_analyzer_diagnostic.category-CodeQuality.severity EditorConfig per abilitare le regole seguenti: IDE0051, IDE0052, IDE0064 e IDE0076. Anche se queste regole iniziano con "IDE", non fanno tecnicamente parte della Style categoria.
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> |
