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.
Petunjuk / Saran
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
Aturan dokumentasi
|
Nilai |
|
Tautan ke aturan |
Aturan dokumentasi |
|
Deskripsi |
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 |
|
Tautan ke aturan |
Aturan globalisasi |
|
Deskripsi |
Aturan globalisasi mendukung pustaka dan aplikasi yang siap untuk pasar global. |
| Nilai EditorConfig |
dotnet_analyzer_diagnostic.category-Globalization.severity |
|
Nilai properti MSBuild |
<AnalysisModeGlobalization> |
Aturan portabilitas dan interoperabilitas
|
Nilai |
|
Tautan ke aturan |
Aturan portabilitas dan interoperabilitas |
|
Deskripsi |
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 keberlanjutan
|
Nilai |
|
Tautan ke aturan |
Aturan pemeliharaan |
|
Deskripsi |
Aturan keberlanjutan mendukung pustaka dan pemeliharaan aplikasi. |
| Nilai EditorConfig |
dotnet_analyzer_diagnostic.category-Maintainability.severity |
|
Nilai properti MSBuild |
<AnalysisModeMaintainability> |
Aturan penamaan
|
Nilai |
|
Tautan ke aturan |
aturan Penamaan |
|
Deskripsi |
Aturan penamaan mendukung kepatuhan terhadap konvensi penamaan pedoman desain .NET. |
| Nilai EditorConfig |
dotnet_analyzer_diagnostic.category-Naming.severity |
|
Nilai properti MSBuild |
<AnalysisModeNaming> |
|
Nilai |
|
Tautan ke aturan |
Aturan performa |
|
Deskripsi |
Aturan performa mendukung pustaka dan aplikasi berkinerja tinggi. |
| Nilai EditorConfig |
dotnet_analyzer_diagnostic.category-Performance.severity |
|
Nilai properti MSBuild |
<AnalysisModePerformance> |
Panduan SingleFile
|
Nilai |
|
Tautan ke aturan |
Aturan SingleFile |
|
Deskripsi |
Aturan file tunggal mendukung aplikasi satu file. |
| Nilai EditorConfig |
dotnet_analyzer_diagnostic.category-SingleFile.severity |
|
Nilai properti MSBuild |
<AnalysisModeSingleFile> |
Aturan keandalan
|
Nilai |
|
Tautan ke aturan |
Aturan keandalan |
|
Deskripsi |
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 |
|
Tautan ke aturan |
Aturan keamanan |
|
Deskripsi |
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 |
|
Tautan ke aturan |
Aturan gaya |
|
Deskripsi |
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 |
|
Tautan ke aturan |
Aturan penggunaan |
|
Deskripsi |
Aturan penggunaan mendukung penggunaan .NET yang tepat. |
| Nilai EditorConfig |
dotnet_analyzer_diagnostic.category-Usage.severity |
|
Nilai properti MSBuild |
<AnalysisModeUsage> |
