CA2251: String.Compare yerine String.Equals kullanın

Özellik Değer
Kural Kimliği CA2251
Başlık String.Equals’yi String.Compare'ye tercih et
Kategori Kullanım
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

Bir String.Compare çağrısının sonucu sıfır ile karşılaştırılır.

Kural açıklaması

String.Compare , sıralama için kullanılabilecek bir toplam düzen karşılaştırması üretmek üzere tasarlanmıştır. Yalnızca dizelerin eşit olup olmadığını önemsiyorsanız, hem daha net hem de büyük olasılıkla daha hızlı olan eşdeğer bir aşırı yükleme kullanmak daha iyidir String.Equals.

İhlalleri düzeltme

Bu kuralın ihlallerini düzeltmek için, String.Compare öğesinin sonucunu karşılaştıran ifadeyi String.Equals çağrısıyla değiştirin.

Example

string leftValue = "...";
string rightValue = "...";

// This code violates the rule.
bool areEqualUsingCompare = string.Compare(leftValue, rightValue, StringComparison.OrdinalIgnoreCase) == 0;

// This code satisfies the rule.
bool areEqualUsingEquals = string.Equals(leftValue, rightValue, StringComparison.OrdinalIgnoreCase);

Uyarıların ne zaman bastırılması gerekiyor?

Bu kuraldan gelen uyarıları engellemek 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 CA2251
// The code that's violating the rule is on this line.
#pragma warning restore CA2251

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.CA2251.severity = none

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

Ayrıca bkz.

  • Last updated on