Minden kódelemzési szabály egy szabálykategóriához tartozik. A tervezési szabályok például támogatják a .NET tervezési irányelveinek betartását, a biztonsági szabályok pedig segítenek megelőzni a biztonsági hibákat. A súlyossági szintet a szabályok teljes kategóriájához konfigurálhatja .
Kategóriánként további beállításokat is konfigurálhat.
Az alábbi táblázat a különböző kódelemzési szabálykategóriákat mutatja be, és az egyes kategóriák szabályaira mutató hivatkozást tartalmaz. Emellett felsorolja azt a konfigurációs értéket is, amelyet egy EditorConfig-fájlban használ a szabály súlyosságának kategória szerinti tömeges konfigurálásához . Ha például a biztonsági szabályok megsértésének súlyosságát hibaként szeretné beállítani, a Szerkesztőkonfiguráció bejegyzés a következő dotnet_analyzer_diagnostic.category-Security.severity = error: .
Jótanács
A szintaxist használó dotnet_analyzer_diagnostic.category-<category>.severity szabályok kategóriájának súlyossága nem vonatkozik az alapértelmezés szerint letiltott szabályokra. A .NET 6-tól kezdve azonban az AnalysisMode Category< projekttulajdonság> használatával engedélyezheti a kategória összes szabályát.
Tervezési szabályok
Dokumentációs szabályok
|
Érték |
|
Hivatkozás szabályokra |
Dokumentációs szabályok |
|
Leírás |
A dokumentációs szabályok a jól dokumentált kódtárak írását támogatják a külsőleg látható API-khoz fűzött XML-dokumentációs megjegyzések helyes használatával. |
|
EditorConfig érték |
dotnet_analyzer_diagnostic.category-Documentation.severity |
|
MSBuild tulajdonság értéke |
<AnalysisModeDocumentation> |
Globalizációs szabályok
|
Érték |
|
Hivatkozás szabályokra |
Globalizációs szabályok |
|
Leírás |
A globalizációs szabályok támogatják a világra kész kódtárakat és alkalmazásokat. |
|
EditorConfig érték |
dotnet_analyzer_diagnostic.category-Globalization.severity |
|
MSBuild tulajdonság értéke |
<AnalysisModeGlobalization> |
Hordozhatóság és együttműködési szabályok
|
Érték |
|
Hivatkozás szabályokra |
Hordozhatóság és együttműködési szabályok |
|
Leírás |
A hordozhatósági szabályok támogatják a különböző platformokon való hordozhatóságot. Az együttműködési szabályok támogatják a COM-ügyfelekkel való interakciót. |
|
EditorConfig érték |
dotnet_analyzer_diagnostic.category-Interoperability.severity |
|
MSBuild tulajdonság értéke |
<AnalysisModeInteroperability> |
Karbantarthatósági szabályok
|
Érték |
|
Hivatkozás szabályokra |
Karbantarthatósági szabályok |
|
Leírás |
A karbantartási szabályok támogatják a kódtár és az alkalmazás karbantartását. |
|
EditorConfig érték |
dotnet_analyzer_diagnostic.category-Maintainability.severity |
|
MSBuild tulajdonság értéke |
<AnalysisModeMaintainability> |
Elnevezési szabályok
|
Érték |
|
Hivatkozás szabályokra |
Elnevezési szabályok |
|
Leírás |
Az elnevezési szabályok támogatják a .NET tervezési irányelveinek elnevezési konvenciók betartását. |
|
EditorConfig érték |
dotnet_analyzer_diagnostic.category-Naming.severity |
|
MSBuild tulajdonság értéke |
<AnalysisModeNaming> |
|
Érték |
|
Hivatkozás szabályokra |
Teljesítményszabályok |
|
Leírás |
A teljesítményszabályok támogatják a nagy teljesítményű kódtárakat és alkalmazásokat. |
|
EditorConfig érték |
dotnet_analyzer_diagnostic.category-Performance.severity |
|
MSBuild tulajdonság értéke |
<AnalysisModePerformance> |
SingleFile-szabályok
|
Érték |
|
Hivatkozás szabályokra |
SingleFile-szabályok |
|
Leírás |
Az egyfájlos szabályok támogatják az egyfájlos alkalmazásokat. |
|
EditorConfig érték |
dotnet_analyzer_diagnostic.category-SingleFile.severity |
|
MSBuild tulajdonság értéke |
<AnalysisModeSingleFile> |
Megbízhatósági szabályok
|
Érték |
|
Hivatkozás szabályokra |
Megbízhatósági szabályok |
|
Leírás |
A megbízhatósági szabályok támogatják a kódtár és az alkalmazások megbízhatóságát, például a megfelelő memória- és szálhasználatot. |
|
EditorConfig érték |
dotnet_analyzer_diagnostic.category-Reliability.severity |
|
MSBuild tulajdonság értéke |
<AnalysisModeReliability> |
Biztonsági szabályok
|
Érték |
|
Hivatkozás szabályokra |
Biztonsági szabályok |
|
Leírás |
A biztonsági szabályok támogatják a biztonságosabb kódtárakat és alkalmazásokat. Ezek a szabályok segítenek megelőzni a program biztonsági hibáit. |
|
EditorConfig érték |
dotnet_analyzer_diagnostic.category-Security.severity |
|
MSBuild tulajdonság értéke |
<AnalysisModeSecurity> |
Stílusszabályok
|
Érték |
|
Hivatkozás szabályokra |
Stílusszabályok |
|
Leírás |
A stílusszabályok támogatják a kódbázis egységes kódstílusát. Ezek a szabályok az "IDE" előtaggal kezdődnek.* |
|
EditorConfig érték |
dotnet_analyzer_diagnostic.category-Style.severity |
|
MSBuild tulajdonság értéke |
<AnalysisModeStyle> |
* A Szerkesztőkonfiguráció értékével dotnet_analyzer_diagnostic.category-CodeQuality.severity engedélyezze a következő szabályokat: IDE0051, IDE0052, IDE0064 és IDE0076. Bár ezek a szabályok az "IDE"-vel kezdődnek, technikailag nem részei a Style kategóriának.
Használati szabályok
|
Érték |
|
Hivatkozás szabályokra |
Használati szabályok |
|
Leírás |
A használati szabályok támogatják a .NET megfelelő használatát. |
|
EditorConfig érték |
dotnet_analyzer_diagnostic.category-Usage.severity |
|
MSBuild tulajdonság értéke |
<AnalysisModeUsage> |
