每個程式代碼分析規則都屬於規則的類別。 例如,設計規則支援遵守 .NET 設計指導方針,而安全性規則有助於防止安全性缺陷。 您可以設定整個規則類別的 嚴重性層級 。 您也可以根據每個類別設定 其他選項 。
下表顯示不同的程式代碼分析規則類別,並提供每個類別中規則的連結。 它也會列出 EditorConfig 檔案中要使用的組態值,以根據每個類別 大量設定規則嚴重性 。 例如,若要將安全性規則違規的嚴重性設定為錯誤,EditorConfig 項目為 dotnet_analyzer_diagnostic.category-Security.severity = error
。
小提示
使用 dotnet_analyzer_diagnostic.category-<category>.severity
語法設定規則類別的嚴重性不適用於預設停用的規則。 不過,從 .NET 6 開始,您可以使用 AnalysisMode<Category> 專案屬性來啟用類別中的所有規則。
設計規則
|
價值觀 |
規則的連結 |
設計規則 |
說明 |
設計規則支援遵循 架構設計指導方針。 |
EditorConfig 值 |
dotnet_analyzer_diagnostic.category-Design.severity |
MSBuild 屬性值 |
<AnalysisModeDesign> |
文件規則
|
價值觀 |
規則的連結 |
文件規則 |
說明 |
文件規則支援針對外部可見 API 正確使用 XML 檔批注,撰寫記載良好的文檔庫。 |
EditorConfig 值 |
dotnet_analyzer_diagnostic.category-Documentation.severity |
MSBuild 屬性值 |
<AnalysisModeDocumentation> |
全球化規則
|
價值觀 |
規則的連結 |
全球化規則 |
說明 |
全球化規則支援全球化準備的函式庫和應用程式。 |
EditorConfig 值 |
dotnet_analyzer_diagnostic.category-Globalization.severity |
MSBuild 屬性值 |
<AnalysisModeGlobalization> |
可移植性和互作性規則
|
價值觀 |
規則的連結 |
可攜性與互通性規則 |
說明 |
可移植性規則支援跨不同平臺的可移植性。 互作性規則支援與 COM 用戶端的互動。 |
EditorConfig 值 |
dotnet_analyzer_diagnostic.category-Interoperability.severity |
MSBuild 屬性值 |
<AnalysisModeInteroperability> |
可維護性規則
|
價值觀 |
規則的連結 |
維護性規則 |
說明 |
可維護性規則支持函式庫和應用程式維護。 |
EditorConfig 值 |
dotnet_analyzer_diagnostic.category-Maintainability.severity |
MSBuild 屬性值 |
<AnalysisModeMaintainability> |
命名規則
|
價值觀 |
規則的連結 |
命名規則 |
說明 |
命名規則支援遵守 .NET 設計指導方針的命名慣例。 |
EditorConfig 值 |
dotnet_analyzer_diagnostic.category-Naming.severity |
MSBuild 屬性值 |
<AnalysisModeNaming> |
|
價值觀 |
規則的連結 |
效能規則 |
說明 |
效能規則支援高效能程式庫與應用程式。 |
EditorConfig 值 |
dotnet_analyzer_diagnostic.category-Performance.severity |
MSBuild 屬性值 |
<AnalysisModePerformance> |
SingleFile 規則
|
價值觀 |
規則的連結 |
SingleFile 規則 |
說明 |
單一檔案規則支援單一檔案應用程式。 |
EditorConfig 值 |
dotnet_analyzer_diagnostic.category-SingleFile.severity |
MSBuild 屬性值 |
<AnalysisModeSingleFile> |
可靠性規則
|
價值觀 |
規則的連結 |
可靠性規則 |
說明 |
可靠性規則支持連結庫和應用程式可靠性,例如正確的記憶體和線程使用量。 |
EditorConfig 值 |
dotnet_analyzer_diagnostic.category-Reliability.severity |
MSBuild 屬性值 |
<AnalysisModeReliability> |
安全性規則
|
價值觀 |
規則的連結 |
安全性規則 |
說明 |
安全性規則支援更安全的連結庫和應用程式。 這些規則有助於防止程式中的安全性缺陷。 |
EditorConfig 值 |
dotnet_analyzer_diagnostic.category-Security.severity |
MSBuild 屬性值 |
<AnalysisModeSecurity> |
樣式規則
|
價值觀 |
規則的連結 |
樣式規則 |
說明 |
樣式規則確保程式碼庫中的程式碼風格一致。 這些規則會以 「IDE」 前置詞開頭。* |
EditorConfig 值 |
dotnet_analyzer_diagnostic.category-Style.severity |
MSBuild 屬性值 |
<AnalysisModeStyle> |
* 使用 EditorConfig 值 dotnet_analyzer_diagnostic.category-CodeQuality.severity
來啟用下列規則: IDE0051、 IDE0052、 IDE0064和 IDE0076。 雖然這些規則以 「IDE」 開頭,但它們在技術上不是類別的 Style
一部分。
使用規則
|
價值觀 |
規則的連結 |
使用規則 |
說明 |
使用規則支援適當的 .NET 使用方式。 |
EditorConfig 值 |
dotnet_analyzer_diagnostic.category-Usage.severity |
MSBuild 屬性值 |
<AnalysisModeUsage> |