Szabálykategóriák

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: .

Tipp.

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

Érték
Hivatkozás szabályokra Tervezési szabályok
Leírás A tervezési szabályok támogatják a keretrendszer tervezési irányelveinek betartását.
EditorConfig érték dotnet_analyzer_diagnostic.category-Design.severity
MSBuild tulajdonság értéke <AnalysisModeDesign>

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>

Teljesítményszabályok

É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>