Aracılığıyla paylaş

CA1046: Başvuru türlerinde eşittir işleçlerini aşırı yüklemeyin

Mülk Değer
Kural Kimliği CA1046
Başlık Eşittir operatörünü referans türlerinde aşırı yüklemeyin
Kategori Tasarım
Düzeltme, bozucu veya bozmayan olabilir Son Dakika
.NET 10'da varsayılan olarak etkin Hayır

Neden

Genel veya iç içe genel başvuru türü, eşitlik işlemcini aşırı yükler.

Kural açıklaması

Başvuru türleri için eşitlik işlecinın varsayılan uygulaması neredeyse her zaman doğrudur. Varsayılan olarak, iki başvuru ancak aynı nesneye işaret ederlerse 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.

Analiz için kodu 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

api_surface seçeneğini ayarlayarak, bu kuralın erişilebilirliği temelinde kod tabanınızın hangi bölümlerinde çalıştırılacaklarını 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

Not

XXXX CAXXXX bölümünü geçerli kuralın kimliğiyle değiştirin.

Ö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($"({a},{b})");
    }
}

Örnek 2

Aşağıdaki uygulama bazı referansları karşılaştırır.

public class ReferenceTypeEquality
{
    public static void Main1046()
    {
        MyReferenceType a = new(2, 2);
        MyReferenceType b = new(2, 2);
        MyReferenceType c = a;

        Console.WriteLine($"a = new {a} and b = new {b} are equal? {(a.Equals(b) ? "Yes" : "No")}");
        Console.WriteLine($"c and a are equal? {(c.Equals(a) ? "Yes" : "No")}");
        Console.WriteLine($"b and a are == ? {(b == a ? "Yes" : "No")}");
        Console.WriteLine($"c and a are == ? {(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

Ayrıca bkz.

  • Last updated on