CA1012: Tipos abstratos não devem ter construtores públicos

Artigo
11/12/2024

Property	valor
ID da regra	CA1012
Título	Tipos abstratos não devem ter construtores públicos
Categoria	Desenho
A correção está quebrando ou não quebrando	Sem quebra
Habilitado por padrão no .NET 9	Não

Motivo

Um tipo é abstrato e tem um construtor público.

Por padrão, essa regra examina apenas tipos visíveis externamente, mas isso é configurável.

Descrição da regra

Construtores em tipos abstratos podem ser chamados apenas por tipos derivados. Como os construtores públicos criam instâncias de um tipo e você não pode criar instâncias de um tipo abstrato, um tipo abstrato que tem um construtor público é projetado incorretamente.

Como corrigir violações

Para corrigir uma violação dessa regra, proteja o construtor ou não declare o tipo como abstrato.

Quando suprimir avisos

Não suprima um aviso desta regra. O tipo abstrato tem um construtor público.

Suprimir um aviso

Se você quiser apenas suprimir uma única violação, adicione diretivas de pré-processador ao seu arquivo de origem para desativar e, em seguida, reativar a regra.

#pragma warning disable CA1012
// The code that's violating the rule is on this line.
#pragma warning restore CA1012

Para desabilitar a regra de um arquivo, pasta ou projeto, defina sua gravidade como none no arquivo de configuração.

[*.{cs,vb}]
dotnet_diagnostic.CA1012.severity = none

Para obter mais informações, consulte Como suprimir avisos de análise de código.

Configurar código para análise

Use a opção a seguir para configurar em quais partes da sua base de código executar essa regra.

Incluir superfícies de API específicas

Você pode configurar essa opção apenas para esta regra, para todas as regras às quais ela se aplica ou para todas as regras nesta categoria (Design) às quais ela se aplica. Para obter mais informações, consulte Opções de configuração da regra de qualidade de código.

Incluir superfícies de API específicas

Você pode configurar em quais partes da sua base de código executar essa regra, com base em sua acessibilidade. Por exemplo, para especificar que a regra deve ser executada somente na superfície de API não pública, adicione o seguinte par chave-valor a um arquivo .editorconfig em seu projeto:

dotnet_code_quality.CAXXXX.api_surface = private, internal

Exemplo

O trecho de código a seguir contém um tipo abstrato que viola essa regra.

' Violates this rule      
Public MustInherit Class Book

    Public Sub New()
    End Sub

End Class

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

O trecho de código a seguir corrige a violação anterior alterando a acessibilidade do construtor de public para protected.

// 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

Partilhar via