Ler em inglês

Compartilhar via


CA2214: Não chamar métodos substituíveis em construtores

Property Valor
ID da regra CA2214
Título Não chamar métodos substituíveis em construtores
Categoria Usage
Correção interruptiva ou sem interrupção Sem interrupção
Habilitado por padrão no .NET 9 Não

Causa

O construtor de um tipo não selado chama um método virtual definido na respectiva classe.

Descrição da regra

Quando um método virtual é chamado, o tipo real que executa o método não é selecionado até o tempo de execução. Quando um construtor chama um método virtual, é possível que o construtor da instância que invoca o método não tenha sido executado. Isso pode resultar em erros ou em um comportamento inesperado se um método virtual substituído depende da inicialização e de outras configurações do construtor.

Como corrigir violações

Para corrigir uma violação dessa regra, não chame os métodos virtuais de um tipo nos construtores do tipo.

Quando suprimir avisos

Não suprima um aviso nessa regra. O construtor deve ser reprojetado para eliminar a chamada ao método virtual.

Exemplo

O exemplo a seguir demonstra o efeito da violação dessa regra. O aplicativo de teste cria uma instância de DerivedType, o que faz com que o construtor da classe base (BadlyConstructedType) seja executado. O construtor do BadlyConstructedType chama incorretamente o método virtual DoSomething. Como a saída mostra, DerivedType.DoSomething() é executado antes da execução do construtor de DerivedType.

C#
public class BadlyConstructedType
{
    protected string initialized = "No";

    public BadlyConstructedType()
    {
        Console.WriteLine("Calling base ctor.");
        // Violates rule: DoNotCallOverridableMethodsInConstructors.
        DoSomething();
    }
    // This will be overridden in the derived type.
    public virtual void DoSomething()
    {
        Console.WriteLine("Base DoSomething");
    }
}

public class DerivedType : BadlyConstructedType
{
    public DerivedType()
    {
        Console.WriteLine("Calling derived ctor.");
        initialized = "Yes";
    }
    public override void DoSomething()
    {
        Console.WriteLine("Derived DoSomething is called - initialized ? {0}", initialized);
    }
}

public class TestBadlyConstructedType
{
    public static void Main2214()
    {
        DerivedType derivedInstance = new DerivedType();
    }
}

Esse exemplo gera a saída a seguir:

txt
Calling base ctor.
Derived DoSomething is called - initialized ? No
Calling derived ctor.