CA1032: Standart özel durum oluşturucuları uygulayın

Makale
09/06/2023

Özellik	Değer
Kural Kimliği	CA1032
Başlık	Standart özel durum oluşturucularını uygulayın
Kategori	Tasarım
Hataya neden olan veya bozulmayan düzeltme	Hataya neden olmayan
.NET 9'da varsayılan olarak etkin	Hayır

Neden

Bir tür genişletir System.Exception ancak tüm gerekli oluşturucuları bildirmez.

Kural açıklaması

Özel durum türlerinin aşağıdaki üç genel oluşturucuyu uygulaması gerekir:

public NewException()
public NewException(dize)
public NewException(dize, Özel Durum)

Yapıcıların tüm ayarlamasını sağlamaktaki başarısızlık, istisnalarla başa çıkmayı zorlaştırabilir. Örneğin, imzaya NewException(string, Exception) sahip oluşturucu, diğer özel durumların neden olduğu özel durumlar oluşturmak için kullanılır. Bu oluşturucu olmadan, yönetilen kodun böyle bir durumda yapması gereken bir iç (iç içe) özel durum içeren özel özel durumunuzun bir örneğini oluşturamaz ve oluşturamazsınız.

Daha fazla bilgi için bkz . CA2229: Serileştirme oluşturucuları uygulama.

İhlalleri düzeltme

Bu kuralın ihlalini düzeltmek için, eksik oluşturucuları özel duruma ekleyin ve doğru erişilebilirliği olduğundan emin olun.

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

İhlal genel oluşturucular için farklı bir erişim düzeyi kullanıldığında bu kuraldan gelen bir uyarıyı 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 CA1032
// The code that's violating the rule is on this line.
#pragma warning restore CA1032

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

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

Örnek

Aşağıdaki örnek, bu kuralı ihlal eden bir özel durum türü ve doğru uygulanan bir özel durum türü içerir.

// Violates rule ImplementStandardExceptionConstructors.
public class BadException : Exception
{
    public BadException()
    {
        // Add any type-specific logic, and supply the default message.
    }
}

[Serializable()]
public class GoodException : Exception
{
    public GoodException()
    {
        // Add any type-specific logic, and supply the default message.
    }

    public GoodException(string message) : base(message)
    {
        // Add any type-specific logic.
    }

    public GoodException(string message, Exception innerException) :
       base(message, innerException)
    {
        // Add any type-specific logic for inner exceptions.
    }
}

Ayrıca bkz.

CA2229: Serileştirme oluşturucularını uygulayın

Aracılığıyla paylaş