CA1309: Sıralı StringComparison kullanın
| Özellik | Değer |
|---|---|
| Kural Kimliği | CA1309 |
| Başlık | Sıralı StringComparison kullanın |
| Kategori | Globalleştirme |
| Hataya neden olan veya bozulmayan düzeltme | Hataya neden olmayan |
| .NET 9'da varsayılan olarak etkin | Hayır |
Neden
Dilbilimsel olmayan bir dize karşılaştırma işlemi, parametresini StringComparison Ordinal veya OrdinalIgnoreCase olarak ayarlamaz.
Kural açıklaması
En önemlisi ve System.String.Equals yöntemleri olan System.String.Compare birçok dize işlemi artık bir numaralandırma değerini parametre olarak kabul System.StringComparison eden bir aşırı yükleme sağlar.
StringComparison.Ordinal veya StringComparison.OrdinalIgnoreCase belirttiğinizde, dize karşılaştırması dilsel değildir. Yani, karşılaştırma kararları alınırken doğal dile özgü özellikler yoksayılır. Doğal dil özelliklerini yoksaymak, kararların kültür tarafından parametreleştirilen büyük/küçük harf veya denklik tablolarına değil basit bayt karşılaştırmalarına dayandığı anlamına gelir. Sonuç olarak, parametreyi StringComparison.Ordinal veya StringComparison.OrdinalIgnoreCase olarak açıkça ayarlayarak kodunuz genellikle hız kazanır, doğruluğu artırır ve daha güvenilir hale gelir.
İhlalleri düzeltme
Bu kuralın ihlalini düzeltmek için dize karşılaştırma yöntemini, numaralandırmayı parametre olarak kabul System.StringComparison eden bir aşırı yüklemeyle değiştirin ve Ordinal veya OrdinalIgnoreCase belirtin. Örneğin, olarak String.Compare(str1, str2, StringComparison.Ordinal)değiştirinString.Compare(str1, str2).
Uyarıların ne zaman bastırılması gerekiyor?
Kitaplık veya uygulama sınırlı bir yerel hedef kitleye yönelik olduğunda veya geçerli kültürün semantiğinin kullanılması gerektiğinde bu kuraldan gelen bir uyarıyı bastırmak güvenlidir.
Uyarıyı gizleme
Yalnızca tek bir ihlali engellemek istiyorsanız, kuralı devre dışı bırakmak ve sonra yeniden etkinleştirmek için kaynak dosyanıza ön işlemci yönergeleri ekleyin.
#pragma warning disable CA1309
// The code that's violating the rule is on this line.
#pragma warning restore CA1309
Bir dosya, klasör veya projenin kuralını devre dışı bırakmak için, yapılandırma dosyasındaki önem derecesini none olarak ayarlayın.
[*.{cs,vb}]
dotnet_diagnostic.CA1309.severity = none
Daha fazla bilgi için bkz . Kod analizi uyarılarını gizleme.
