Бөлісу құралы:

CA2215: Методы Dispose должны вызывать метод Dispose базового класса.

Свойство Значение
Идентификатор правила CA2215
Заголовок Метод Dispose должен вызывать базовый класс Dispose
Категория Использование
Исправление является критическим или не критическим неразрывный
Включен по умолчанию в .NET 10 Нет
Применимые языки C# и Visual Basic

Причина

Тип, реализующий System.IDisposable, наследует от типа, который также реализует IDisposable. Метод Dispose наследуемого типа не вызывает метод Dispose родительского типа.

Описание правила

Если тип наследует от освобождаемого типа, он должен вызывать метод Dispose базового типа из собственного метода Dispose. Вызов метода базового типа Dispose гарантирует, что все ресурсы, созданные базовым типом, будут освобождены.

Устранение нарушений

Чтобы устранить нарушение этого правила, вызовите base.Dispose в вашем методе Dispose.

Когда лучше отключить предупреждения

Это безопасно подавить предупреждение этого правила, если вызов baseDispose происходит на более глубоком уровне вызова, чем уровень проверки правила.

Отключение предупреждений

Если вы просто хотите отключить одно нарушение, добавьте директивы препроцессора в исходный файл, чтобы отключить и повторно включить правило.

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

Чтобы отключить правило для файла, папки или проекта, задайте его серьезность none в файле конфигурации.

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

Дополнительные сведения см. в разделе Практическое руководство. Скрытие предупреждений анализа кода.

Пример

В следующем примере показаны два типа: TypeA, реализующий IDisposable, и TypeB, который наследуется от типа TypeA и правильно вызывает свой метод Dispose.

Namespace ca2215

    Public Class TypeA
        Implements IDisposable

        Protected Overridable Overloads Sub Dispose(disposing As Boolean)
            If disposing Then
                ' dispose managed resources
            End If
            
            ' free native resources
        End Sub

        Public Overloads Sub Dispose() Implements IDisposable.Dispose
            Dispose(True)
            GC.SuppressFinalize(Me)
        End Sub

        ' Disposable types implement a finalizer.
        Protected Overrides Sub Finalize()
            Dispose(False)
            MyBase.Finalize()
        End Sub

    End Class

    Public Class TypeB
        Inherits TypeA

        Protected Overrides Sub Dispose(disposing As Boolean)
            If Not disposing Then
                MyBase.Dispose(False)
            End If
        End Sub

    End Class

End Namespace

using System;

namespace ca2215
{
    public class TypeA : IDisposable
    {
        protected virtual void Dispose(bool disposing)
        {
            if (disposing)
            {
                // Dispose managed resources
            }

            // Free native resources
        }

        public void Dispose()
        {
            Dispose(true);
            GC.SuppressFinalize(this);
        }

        // Disposable types implement a finalizer.
        ~TypeA()
        {
            Dispose(false);
        }
    }

    public class TypeB : TypeA
    {
        protected override void Dispose(bool disposing)
        {
            if (!disposing)
            {
                base.Dispose(false);
            }
        }
    }
}

См. также

  • Last updated on