CA1012: Soyut türlerin ortak oluşturucuları olmamalıdır

Özellik Değer
Kural Kimliği CA1012
Başlık Soyut türlerin genel oluşturucuları olmamalıdır
Kategori Tasarı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 tür soyut ve ortak bir oluşturucuya sahiptir.

Varsayılan olarak, bu kural yalnızca dışarıdan görünen türlere bakar, ancak bu yapılandırılabilir.

Kural açıklaması

Soyut türlerdeki yapıcılar yalnızca türetilen türler tarafından çağrılabilir. Ortak oluşturucular bir türün örneklerini oluşturduğundan ve bir soyut türün örneklerini oluşturamadığınız için, genel oluşturucuya sahip soyut bir tür yanlış tasarlanmıştır.

İhlalleri düzeltme

Bu kuralın ihlalini düzeltmek için oluşturucuyu korumalı yapın veya türü soyut olarak bildirmeyin.

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

Bu kuraldan uyarıyı bastırmayın. Soyut türün bir ortak oluşturucu vardır.

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

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

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

Kod çözümleme için konfigüre et

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

Aşağıdaki kod parçacığı, bu kuralı ihlal eden bir soyut tür içerir.

' Violates this rule      
Public MustInherit Class Book

    Public Sub New()
    End Sub

End Class

// Violates this rule
public abstract class Book
{
    public Book()
    {
    }
}

Aşağıdaki kod parçacığı, oluşturucunun public ile protected erişimini değiştirerek önceki ihlali düzeltir.

// Does not violate this rule
public abstract class Book
{
    protected Book()
    {
    }
}

' Violates this rule      
Public MustInherit Class Book

    Protected Sub New()
    End Sub

End Class
  • Last updated on