CA1046: Başvuru türlerinde eşittir işleçlerini aşırı yüklemeyin
| Özellik | Değer |
|---|---|
| Kural Kimliği | CA1046 |
| Başlık | Eşittir işlecini başvuru türlerinde aşırı yüklemeyin |
| Kategori | Tasarım |
| Hataya neden olan veya bozulmayan düzeltme | Yeni |
| .NET 8'de varsayılan olarak etkin | Hayır |
Neden
Genel veya iç içe genel başvuru türü, eşitlik işlecini aşırı yükler.
Kural açıklaması
Başvuru türleri için, varsayılan eşitlik işleci neredeyse her zaman doğrudur. Varsayılan olarak, yalnızca aynı nesneye gelirseniz iki başvuru eşit olur.
İhlalleri düzeltme
Bu kuralın ihlalini düzeltmek için eşitlik işlecinin uygulamasını kaldırın.
Uyarıların ne zaman bastırılması gerekiyor?
Başvuru türü yerleşik bir değer türü gibi davrandığında bu kuraldan gelen bir uyarıyı engellemek güvenlidir. Türün örneklerinde toplama veya çıkarma yapmak anlamlıysa, eşitlik işlecini uygulamak ve ihlali bastırmak büyük olasılıkla doğrudur.
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 CA1046
// The code that's violating the rule is on this line.
#pragma warning restore CA1046
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.CA1046.severity = none
Daha fazla bilgi için bkz . Kod analizi uyarılarını gizleme.
Çözümlemek için kod yapılandırma
Bu kuralın kod tabanınızın hangi bölümlerinde çalıştırılacaklarını yapılandırmak için aşağıdaki seçeneği kullanın.
Bu seçeneği yalnızca bu kural, geçerli olduğu tüm kurallar veya bu kategorideki (Tasarım) tüm kurallar için yapılandırabilirsiniz. Daha fazla bilgi için bkz . Kod kalitesi kuralı yapılandırma seçenekleri.
Belirli API yüzeylerini ekleme
Bu kuralın üzerinde çalıştırılacak kod tabanınızın hangi bölümlerini erişilebilirliklerine göre yapılandırabilirsiniz. Örneğin, kuralın yalnızca genel olmayan API yüzeyinde çalıştırılması gerektiğini belirtmek için projenizdeki bir .editorconfig dosyasına aşağıdaki anahtar-değer çiftini ekleyin:
dotnet_code_quality.CAXXXX.api_surface = private, internal
Örnek 1
Aşağıdaki örnekte, iki başvuru karşılaştırıldığında varsayılan davranış gösterilmektedir.
public class MyReferenceType
{
private int a, b;
public MyReferenceType(int a, int b)
{
this.a = a;
this.b = b;
}
public override string ToString()
{
return String.Format("({0},{1})", a, b);
}
}
Örnek 2
Aşağıdaki uygulama bazı başvuruları karşılaştırır.
public class ReferenceTypeEquality
{
public static void Main1046()
{
MyReferenceType a = new MyReferenceType(2, 2);
MyReferenceType b = new MyReferenceType(2, 2);
MyReferenceType c = a;
Console.WriteLine("a = new {0} and b = new {1} are equal? {2}", a, b, a.Equals(b) ? "Yes" : "No");
Console.WriteLine("c and a are equal? {0}", c.Equals(a) ? "Yes" : "No");
Console.WriteLine("b and a are == ? {0}", b == a ? "Yes" : "No");
Console.WriteLine("c and a are == ? {0}", c == a ? "Yes" : "No");
}
}
Bu örnek aşağıdaki çıkışı oluşturur:
a = new (2,2) and b = new (2,2) are equal? No
c and a are equal? Yes
b and a are == ? No
c and a are == ? Yes
