Aracılığıyla paylaş

CA2011: Ayarlayıcı içinde özellik atama

  • Makale
Özellik Değer
Kural Kimliği CA2011
Başlık Özelliği, ayarlayıcısı içinde atama
Kategori Güvenilirlik
Hataya neden olan veya bozulmayan düzeltme Hataya neden olmayan
.NET 9'da varsayılan olarak etkin Öneri olarak

Neden

Bir özelliğe yanlışlıkla kendi kümesi erişimcisinde bir değer atandı.

Kural açıklaması

Bir özelliği küme erişimcisinde kendisine atamak, küme erişimcisine sonsuz özyinelemeli çağrılar zincirine yol açar. Bu, çalışma zamanında sonucunu StackOverflowException döndürür. Özellik değerini depolamak için özellik ve yedekleme alanı benzer adlara sahip olduğunda bu tür bir hata yaygındır. Değeri yedekleme alanına atamak yerine yanlışlıkla özelliğin kendisine atanmıştır.

İhlalleri düzeltme

İhlalleri düzeltmek için özelliğe yönelik ihlal eden atamayı, yedekleme alanına yapılan bir atamayla değiştirin veya otomatik özellik kullanmaya geçin. Örneğin, aşağıdaki kod parçacığı kuralın ihlalini ve bunu düzeltmenin birkaç yolunu gösterir:

public class C
{
    // Backing field for property 'P'
    private int p;

    public int P
    {
        get
        {
            return p;
        }
        set
        {
            // CA2011: Accidentally assigned to property, instead of the backing field.
            P = value;
        }
    }
}

public class C
{
    // Backing field for property 'P'
    private int _p;

    public int P
    {
        get
        {
            return _p;
        }
        set
        {
            // Option 1: Assign to backing field and rename the backing field for clarity.
            _p = value;
        }
    }
}

public class C
{
    // Option 2: Use auto-property.
    public int P { get; set; }
}

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

Küme erişimcisine yapılan özyinelemeli çağrıların sonsuz özyinelemeliliği önlemek için koşullu olarak korunduğunu düşünüyorsanız, bu kuraldaki ihlalleri gizlemeniz iyi olur.

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 CA2011
// The code that's violating the rule is on this line.
#pragma warning restore CA2011

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

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

Ayrıca bkz.