CA1309: Ordinal StringComparison kullanın

Özellik Değer
Kural Kimliği CA1309
Başlık Sıralı StringComparison kullanın
Kategori Globalleştirme
Düzeltme bozucu ya da bozmayan olabilir Kesintisiz
.NET 10'da varsayılan olarak etkin Hayır
Geçerli diller C# ve Visual Basic

Neden

Dilbilimsel olmayan bir dize karşılaştırma işlemi, parametresini StringComparisonOrdinal veya OrdinalIgnoreCase olarak ayarlamaz.

Kural açıklaması

En önemlileri System.String.Compare ve System.String.Equals metotları olan birçok dize işlemi, artık bir numaralandırma değerini parametre olarak kabul eden bir aşırı yükleme sağlamaktadır.

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üre göre parametreleştirilen büyük/küçük harf veya denklik tabanlı tablolara 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, System.StringComparison numaralandırmayı parametre olarak kabul eden bir aşırı yüklemeyle dize karşılaştırma yöntemini değiştirin ve Ordinal veya OrdinalIgnoreCase belirtin. Örneğin, String.Compare(str1, str2)'yi String.Compare(str1, str2, StringComparison.Ordinal) ile değiştirin.

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 noneolarak ayarlayın.

[*.{cs,vb}]
dotnet_diagnostic.CA1309.severity = none

Daha fazla bilgi için bkz . Kod analizi uyarılarını gizleme.

Ayrıca bkz.

  • Last updated on