Každé pravidlo analýzy kódu patří do kategorie pravidel. Pravidla návrhu například podporují dodržování pokynů pro návrh .NET a pravidla zabezpečení pomáhají zabránit chybám zabezpečení. Úroveň závažnosti můžete nakonfigurovat pro celou kategorii pravidel. Můžete také nakonfigurovat další možnosti pro jednotlivé kategorie.
Následující tabulka ukazuje různé kategorie pravidel analýzy kódu a poskytuje odkaz na pravidla v každé kategorii. Obsahuje také hodnotu konfigurace, která se má použít v souboru EditorConfig pro hromadnou konfiguraci závažnosti pravidla pro každou kategorii. Chcete-li například nastavit závažnost porušení pravidel zabezpečení na chyby, položka EditorConfig je dotnet_analyzer_diagnostic.category-Security.severity = error
.
Návod
Nastavení závažnosti pro kategorii pravidel pomocí dotnet_analyzer_diagnostic.category-<category>.severity
syntaxe se nevztahuje na pravidla, která jsou ve výchozím nastavení zakázaná. Počínaje rozhraním .NET 6 však můžete pomocí vlastnosti projektu AnalysisMode<Category> povolit všechna pravidla v kategorii.
Pravidla návrhu
Pravidla dokumentace
|
Hodnota |
Odkaz na pravidla |
Pravidla dokumentace |
Popis |
Pravidla dokumentace podporují psaní dobře zdokumentovaných knihoven prostřednictvím správného použití komentářů dokumentace XML pro externě viditelná rozhraní API. |
Hodnota EditorConfig |
dotnet_analyzer_diagnostic.category-Documentation.severity |
Hodnota vlastnosti MSBuild |
<AnalysisModeDocumentation> |
Pravidla globalizace
|
Hodnota |
Odkaz na pravidla |
Pravidla globalizace |
Popis |
Pravidla globalizace podporují knihovny a aplikace připravené pro globální použití. |
Hodnota EditorConfig |
dotnet_analyzer_diagnostic.category-Globalization.severity |
Hodnota vlastnosti MSBuild |
<AnalysisModeGlobalization> |
Pravidla přenositelnosti a interoperability
|
Hodnota |
Odkaz na pravidla |
Pravidla přenositelnosti a interoperability |
Popis |
Pravidla přenositelnosti podporují přenositelnost napříč různými platformami. Pravidla interoperability podporují interakci s klienty COM. |
Hodnota EditorConfig |
dotnet_analyzer_diagnostic.category-Interoperability.severity |
Hodnota vlastnosti MSBuild |
<AnalysisModeInteroperability> |
Pravidla udržovatelnosti
|
Hodnota |
Odkaz na pravidla |
Pravidla udržovatelnosti |
Popis |
Pravidla udržovatelnosti podporují knihovnu a údržbu aplikací. |
Hodnota EditorConfig |
dotnet_analyzer_diagnostic.category-Maintainability.severity |
Hodnota vlastnosti MSBuild |
<AnalysisModeMaintainability> |
Pravidla pojmenování
|
Hodnota |
Odkaz na pravidla |
pravidla pojmenování |
Popis |
Pravidla pojmenování podporují dodržování konvencí pojmenování podle pokynů pro návrh .NET. |
Hodnota EditorConfig |
dotnet_analyzer_diagnostic.category-Naming.severity |
Hodnota vlastnosti MSBuild |
<AnalysisModeNaming> |
|
Hodnota |
Odkaz na pravidla |
Pravidla výkonu |
Popis |
Pravidla výkonu podporují vysoce výkonné knihovny a aplikace. |
Hodnota EditorConfig |
dotnet_analyzer_diagnostic.category-Performance.severity |
Hodnota vlastnosti MSBuild |
<AnalysisModePerformance> |
Pravidla singlefile
|
Hodnota |
Odkaz na pravidla |
Pravidla singlefile |
Popis |
Pravidla jednosouborového použití podporují jednosouborové aplikace. |
Hodnota EditorConfig |
dotnet_analyzer_diagnostic.category-SingleFile.severity |
Hodnota vlastnosti MSBuild |
<AnalysisModeSingleFile> |
Pravidla spolehlivosti
|
Hodnota |
Odkaz na pravidla |
Pravidla spolehlivosti |
Popis |
Pravidla spolehlivosti podporují knihovnu a spolehlivost aplikací, například správné využití paměti a vlákna. |
Hodnota EditorConfig |
dotnet_analyzer_diagnostic.category-Reliability.severity |
Hodnota vlastnosti MSBuild |
<AnalysisModeReliability> |
Pravidla zabezpečení
|
Hodnota |
Odkaz na pravidla |
Pravidla zabezpečení |
Popis |
Pravidla zabezpečení podporují bezpečnější knihovny a aplikace. Tato pravidla pomáhají zabránit chybám zabezpečení ve vašem programu. |
Hodnota EditorConfig |
dotnet_analyzer_diagnostic.category-Security.severity |
Hodnota vlastnosti MSBuild |
<AnalysisModeSecurity> |
Pravidla stylu
|
Hodnota |
Odkaz na pravidla |
Pravidla stylu |
Popis |
Pravidla stylu podporují konzistentní styl kódu v základu kódu. Tato pravidla začínají předponou IDE.* |
Hodnota EditorConfig |
dotnet_analyzer_diagnostic.category-Style.severity |
Hodnota vlastnosti MSBuild |
<AnalysisModeStyle> |
* Pomocí hodnoty dotnet_analyzer_diagnostic.category-CodeQuality.severity
EditorConfig povolte následující pravidla: IDE0051, IDE0052, IDE0064 a IDE0076. I když tato pravidla začínají "IDE", nejsou technicky součástí Style
kategorie.
Pravidla použití
|
Hodnota |
Odkaz na pravidla |
Pravidla použití |
Popis |
Pravidla použití podporují správné využití .NET. |
Hodnota EditorConfig |
dotnet_analyzer_diagnostic.category-Usage.severity |
Hodnota vlastnosti MSBuild |
<AnalysisModeUsage> |