Kategori aturan

Setiap aturan analisis kode termasuk dalam kategori aturan. Misalnya, aturan desain mendukung kepatuhan terhadap pedoman desain .NET, dan aturan keamanan membantu mencegah kelemahan keamanan. Anda dapat mengonfigurasi tingkat keparahan untuk seluruh kategori aturan. Anda juga dapat mengonfigurasi opsi tambahan berdasarkan per kategori.

Tabel berikut ini memperlihatkan kategori aturan analisis kode yang berbeda dan menyediakan tautan ke aturan di setiap kategori. Ini juga mencantumkan nilai konfigurasi yang akan digunakan dalam file EditorConfig untuk mengonfigurasi tingkat keparahan aturan secara massal berdasarkan per kategori. Misalnya, untuk mengatur tingkat keparahan pelanggaran aturan keamanan menjadi kesalahan, entri EditorConfig adalah dotnet_analyzer_diagnostic.category-Security.severity = error.

Tip

Mengatur tingkat keparahan untuk kategori aturan menggunakan dotnet_analyzer_diagnostic.category-<category>.severity sintaksis tidak berlaku untuk aturan yang dinonaktifkan secara default. Namun, mulai dari .NET 6, Anda dapat menggunakan properti proyek Kategori> AnalysisMode<untuk mengaktifkan semua aturan dalam kategori.

Aturan desain

Nilai
Menautkan ke aturan Aturan desain
Keterangan Aturan desain mendukung kepatuhan terhadap pedoman desain Kerangka Kerja.
Nilai EditorConfig dotnet_analyzer_diagnostic.category-Design.severity
Nilai properti MSBuild <AnalysisModeDesign>

Aturan dokumentasi

Nilai
Menautkan ke aturan Aturan dokumentasi
Keterangan Aturan dokumentasi mendukung penulisan pustaka yang didokumentasikan dengan baik melalui penggunaan komentar dokumentasi XML yang benar untuk API yang terlihat secara eksternal.
Nilai EditorConfig dotnet_analyzer_diagnostic.category-Documentation.severity
Nilai properti MSBuild <AnalysisModeDocumentation>

Aturan globalisasi

Nilai
Menautkan ke aturan Aturan globalisasi
Keterangan Aturan globalisasi mendukung pustaka dan aplikasi yang siap di dunia.
Nilai EditorConfig dotnet_analyzer_diagnostic.category-Globalization.severity
Nilai properti MSBuild <AnalysisModeGlobalization>

Aturan portabilitas dan interoperabilitas

Nilai
Menautkan ke aturan Aturan portabilitas dan interoperabilitas
Keterangan Aturan portabilitas mendukung portabilitas di berbagai platform. Aturan interoperabilitas mendukung interaksi dengan klien COM.
Nilai EditorConfig dotnet_analyzer_diagnostic.category-Interoperability.severity
Nilai properti MSBuild <AnalysisModeInteroperability>

Aturan pemeliharaan

Nilai
Menautkan ke aturan Aturan pemeliharaan
Keterangan Aturan keberlanjutan mendukung pustaka dan pemeliharaan aplikasi.
Nilai EditorConfig dotnet_analyzer_diagnostic.category-Maintainability.severity
Nilai properti MSBuild <AnalysisModeMaintainability>

Aturan penamaan

Nilai
Menautkan ke aturan Aturan penamaan
Keterangan Aturan penamaan mendukung kepatuhan terhadap konvensi penamaan pedoman desain .NET.
Nilai EditorConfig dotnet_analyzer_diagnostic.category-Naming.severity
Nilai properti MSBuild <AnalysisModeNaming>

Aturan performa

Nilai
Menautkan ke aturan Aturan performa
Keterangan Aturan performa mendukung pustaka dan aplikasi berkinerja tinggi.
Nilai EditorConfig dotnet_analyzer_diagnostic.category-Performance.severity
Nilai properti MSBuild <AnalysisModePerformance>

Aturan SingleFile

Nilai
Menautkan ke aturan Aturan SingleFile
Keterangan Aturan file tunggal mendukung aplikasi file tunggal.
Nilai EditorConfig dotnet_analyzer_diagnostic.category-SingleFile.severity
Nilai properti MSBuild <AnalysisModeSingleFile>

Aturan keandalan

Nilai
Menautkan ke aturan Aturan keandalan
Keterangan Aturan keandalan mendukung pustaka dan keandalan aplikasi, seperti memori dan penggunaan utas yang benar.
Nilai EditorConfig dotnet_analyzer_diagnostic.category-Reliability.severity
Nilai properti MSBuild <AnalysisModeReliability>

Aturan keamanan

Nilai
Menautkan ke aturan Aturan keamanan
Keterangan Aturan keamanan mendukung pustaka dan aplikasi yang lebih aman. Aturan ini membantu mencegah kelemahan keamanan dalam program Anda.
Nilai EditorConfig dotnet_analyzer_diagnostic.category-Security.severity
Nilai properti MSBuild <AnalysisModeSecurity>

Aturan gaya

Nilai
Menautkan ke aturan Aturan gaya
Keterangan Aturan gaya mendukung gaya kode yang konsisten di basis kode Anda. Aturan ini dimulai dengan awalan "IDE".*
Nilai EditorConfig dotnet_analyzer_diagnostic.category-Style.severity
Nilai properti MSBuild <AnalysisModeStyle>

* Gunakan nilai dotnet_analyzer_diagnostic.category-CodeQuality.severity EditorConfig untuk mengaktifkan aturan berikut: IDE0051, IDE0052, IDE0064, dan IDE0076. Meskipun aturan ini dimulai dengan "IDE", aturan tersebut bukan bagian Style teknis dari kategori.

Aturan penggunaan

Nilai
Menautkan ke aturan Aturan penggunaan
Keterangan Aturan penggunaan mendukung penggunaan .NET yang tepat.
Nilai EditorConfig dotnet_analyzer_diagnostic.category-Usage.severity
Nilai properti MSBuild <AnalysisModeUsage>