Partilhar via


CA2015: Não defina finalizadores para tipos derivados do MemoryManager<T>

Propriedade valor
ID da regra CA2015
Título Não defina finalizadores para tipos derivados de MemoryManager<T>
Categoria Fiabilidade
A correção causa interrupção ou não Ininterrupto
Habilitado por padrão no .NET 10 Como aviso
Línguas aplicáveis C# e Visual Basic

Motivo

Definição de finalizadores para tipos derivados de MemoryManager<T>

Descrição da regra

Adicionar um finalizador a um tipo derivado de MemoryManager<T> é provavelmente uma indicação de um bug, pois sugere que um recurso nativo que poderia ter sido alocado em um Span<T> está a ser limpo e, potencialmente, enquanto ainda está em uso pelo Span<T>.

Nota

A MemoryManager<T> classe destina-se a cenários avançados. A maioria dos desenvolvedores não precisa usá-lo.

Como corrigir violações

Para corrigir a violação, remova a definição do finalizador.

class DerivedClass <T> : MemoryManager<T>
{
    public override bool Dispose(bool disposing)
    {
        if (disposing)
        {
            _handle.Dispose();
        }
    }

    ...

    // Violation occurs, remove the finalizer to fix the warning.
    ~DerivedClass() => Dispose(false);
}

Quando suprimir avisos

É seguro suprimir uma violação desta regra se a intenção for criar um finalizador para fins de depuração ou validação.

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

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

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

Para desativar toda essa categoria de regras, defina a severidade da categoria como none no arquivo de configuração.

[*.{cs,vb}]
dotnet_analyzer_diagnostic.category-Reliability.severity = none

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

Consulte também