Kural kategorileri

  • Makale

Her kod çözümleme kuralı bir kural kategorisine aittir. Örneğin, tasarım kuralları .NET tasarım yönergelerine uymayı destekler ve güvenlik kuralları güvenlik açıklarının önlenmesine yardımcı olur. Kural kategorisinin tamamı için önem düzeyini yapılandırabilirsiniz. Ayrıca kategori bazında ek seçenekler de yapılandırabilirsiniz.

Aşağıdaki tabloda farklı kod çözümleme kuralı kategorileri gösterilir ve her kategorideki kuralların bağlantısı sağlanır. Ayrıca, kural önem derecesini kategori başına toplu olarak yapılandırmak için EditorConfig dosyasında kullanılacak yapılandırma değerini de listeler. Örneğin, güvenlik kuralı ihlallerinin önem derecesini hata olarak ayarlamak için EditorConfig girdisi olur dotnet_analyzer_diagnostic.category-Security.severity = error.

İpucu

Söz dizimini kullanarak bir kural kategorisinin önem derecesini dotnet_analyzer_diagnostic.category-<category>.severity ayarlamak, varsayılan olarak devre dışı bırakılan kurallar için geçerli değildir. Ancak, .NET 6'dan başlayarak, bir kategorideki tüm kuralları etkinleştirmek için AnalysisMode<Category> proje özelliğini kullanabilirsiniz.

Tasarım kuralları

Değer
Kurallara bağlantı Tasarım kuralları
Açıklama Tasarım kuralları, Çerçeve tasarım yönergelerine bağlı kalmayı destekler.
EditorConfig değeri dotnet_analyzer_diagnostic.category-Design.severity
MSBuild özellik değeri <AnalysisModeDesign>

Belge kuralları

Değer
Kurallara bağlantı Belge kuralları
Açıklama Belge kuralları, dışarıdan görünür API'ler için XML belge açıklamalarının doğru kullanımı aracılığıyla iyi belgelenmiş kitaplıklar yazmayı destekler.
EditorConfig değeri dotnet_analyzer_diagnostic.category-Documentation.severity
MSBuild özellik değeri <AnalysisModeDocumentation>

Genelleştirme kuralları

Değer
Kurallara bağlantı Genelleştirme kuralları
Açıklama Genelleştirme kuralları, dünya çapında kullanıma hazır kitaplıkları ve uygulamaları destekler.
EditorConfig değeri dotnet_analyzer_diagnostic.category-Globalization.severity
MSBuild özellik değeri <AnalysisModeGlobalization>

Taşınabilirlik ve birlikte çalışabilirlik kuralları

Değer
Kurallara bağlantı Taşınabilirlik ve birlikte çalışabilirlik kuralları
Açıklama Taşınabilirlik kuralları farklı platformlarda taşınabilirliği destekler. Birlikte çalışabilirlik kuralları COM istemcileri ile etkileşimi destekler.
EditorConfig değeri dotnet_analyzer_diagnostic.category-Interoperability.severity
MSBuild özellik değeri <AnalysisModeInteroperability>

Bakım kuralları

Değer
Kurallara bağlantı Bakım kuralları
Açıklama Bakım kuralları kitaplık ve uygulama bakımını destekler.
EditorConfig değeri dotnet_analyzer_diagnostic.category-Maintainability.severity
MSBuild özellik değeri <AnalysisModeMaintainability>

Adlandırma kuralları

Değer
Kurallara bağlantı Adlandırma kuralları
Açıklama Adlandırma kuralları, .NET tasarım yönergelerinin adlandırma kurallarına uyulmayı destekler.
EditorConfig değeri dotnet_analyzer_diagnostic.category-Naming.severity
MSBuild özellik değeri <AnalysisModeNaming>

Performans kuralları

Değer
Kurallara bağlantı Performans kuralları
Açıklama Performans kuralları yüksek performanslı kitaplıkları ve uygulamaları destekler.
EditorConfig değeri dotnet_analyzer_diagnostic.category-Performance.severity
MSBuild özellik değeri <AnalysisModePerformance>

SingleFile kuralları

Değer
Kurallara bağlantı SingleFile kuralları
Açıklama Tek dosyalı kurallar tek dosyalı uygulamaları destekler.
EditorConfig değeri dotnet_analyzer_diagnostic.category-SingleFile.severity
MSBuild özellik değeri <AnalysisModeSingleFile>

Güvenilirlik kuralları

Değer
Kurallara bağlantı Güvenilirlik kuralları
Açıklama Güvenilirlik kuralları, doğru bellek ve iş parçacığı kullanımı gibi kitaplık ve uygulama güvenilirliğini destekler.
EditorConfig değeri dotnet_analyzer_diagnostic.category-Reliability.severity
MSBuild özellik değeri <AnalysisModeReliability>

Güvenlik kuralları

Değer
Kurallara bağlantı Güvenlik kuralları
Açıklama Güvenlik kuralları daha güvenli kitaplıkları ve uygulamaları destekler. Bu kurallar, programınızdaki güvenlik açıklarını önlemeye yardımcı olur.
EditorConfig değeri dotnet_analyzer_diagnostic.category-Security.severity
MSBuild özellik değeri <AnalysisModeSecurity>

Stil kuralları

Değer
Kurallara bağlantı Stil kuralları
Açıklama Stil kuralları, kod tabanınızda tutarlı kod stilini destekler. Bu kurallar "IDE" ön eki ile başlar.*
EditorConfig değeri dotnet_analyzer_diagnostic.category-Style.severity
MSBuild özellik değeri <AnalysisModeStyle>

* Şu kuralları etkinleştirmek için EditorConfig değerini dotnet_analyzer_diagnostic.category-CodeQuality.severity kullanın: IDE0051, IDE0052, IDE0064 ve IDE0076. Bu kurallar "IDE" ile başlasa da teknik olarak kategorinin Style bir parçası değildir.

Kullanım kuralları

Değer
Kurallara bağlantı Kullanım kuralları
Açıklama Kullanım kuralları .NET'in düzgün kullanımını destekler.
EditorConfig değeri dotnet_analyzer_diagnostic.category-Usage.severity
MSBuild özellik değeri <AnalysisModeUsage>