各コード分析ルールは、ルールのカテゴリに属します。 たとえば、設計規則は .NET 設計ガイドラインへの準拠をサポートし、セキュリティ規則はセキュリティ上の欠陥を防ぐのに役立ちます。 ルールのカテゴリ全体 の重大度レベルを構成 できます。 カテゴリごとに 追加のオプションを構成 することもできます。
次の表に、さまざまなコード分析規則のカテゴリを示し、各カテゴリのルールへのリンクを示します。 また、EditorConfig ファイルで使用する構成値を一覧表示して、カテゴリごとに ルールの重大度を一括構成 します。 たとえば、セキュリティ規則違反の重大度をエラーに設定するには、EditorConfig エントリが dotnet_analyzer_diagnostic.category-Security.severity = error。
ヒント
dotnet_analyzer_diagnostic.category-<category>.severity構文を使用してルールのカテゴリの重大度を設定することは、既定で無効になっているルールには適用されません。 ただし、.NET 6 以降では、 AnalysisMode<Category> プロジェクト プロパティを使用して、カテゴリ内のすべてのルールを有効にすることができます。
設計規則
ドキュメントルール
|
価値 |
|
ルールへのリンク |
ドキュメント規則 |
|
説明 |
ドキュメント ルールでは、外部から参照できる 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> |
