共用方式為


規則類別

每個程式代碼分析規則都屬於規則的類別。 例如,設計規則支援遵守 .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 來啟用下列規則: IDE0051IDE0052IDE0064IDE0076。 雖然這些規則以 「IDE」 開頭,但它們在技術上不是類別的 Style 一部分。

使用規則

價值觀
規則的連結 使用規則
說明 使用規則支援適當的 .NET 使用方式。
EditorConfig 值 dotnet_analyzer_diagnostic.category-Usage.severity
MSBuild 屬性值 <AnalysisModeUsage>