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

Propriedade	valor
ID da regra	CA2214
Título	Não chame métodos substituíveis em construtores
Categoria	Utilização
A correção está a causar problemas ou não	Sem quebra
Habilitado por padrão no .NET 9	Não

Motivo

O construtor de um tipo não selado chama um método virtual definido na sua 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 invoca um método virtual, é possível que o construtor da instância que invoca o método ainda não tenha sido executado. Isso pode levar a erros ou comportamento inesperado, se um método virtual substituído depende de inicialização e outra configuração no construtor.

Como corrigir violações

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

Quando suprimir avisos

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

Exemplo

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

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 ? {initialized}");
    }
}

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

Imports System

Namespace ca2214

    Public Class BadlyConstructedType
        Protected initialized As String = "No"


        Public Sub New()
            Console.WriteLine("Calling base ctor.")
            ' Violates rule: DoNotCallOverridableMethodsInConstructors.
            DoSomething()
        End Sub 'New

        ' This will be overridden in the derived type.
        Public Overridable Sub DoSomething()
            Console.WriteLine("Base DoSomething")
        End Sub 'DoSomething
    End Class 'BadlyConstructedType


    Public Class DerivedType
        Inherits BadlyConstructedType

        Public Sub New()
            Console.WriteLine("Calling derived ctor.")
            initialized = "Yes"
        End Sub 'New

        Public Overrides Sub DoSomething()
            Console.WriteLine("Derived DoSomething is called - initialized ? {0}", initialized)
        End Sub 'DoSomething
    End Class 'DerivedType


    Public Class TestBadlyConstructedType

        Public Shared Sub Main2214()
            Dim derivedInstance As New DerivedType()
        End Sub 'Main
    End Class
End Namespace

Este exemplo produz a seguinte saída:

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