C#中的IDisposable接口怎么用 C# using语句和Dispose模式的实现

来源:这里教程网 时间:2026-02-21 17:30:11 作者:

在C#中,IDisposable接口用于手动管理非托管资源(如文件句柄、数据库连接、网络连接等),确保这些资源能及时释放。.NET虽然有垃圾回收机制(GC),但它只负责清理托管内存,无法自动释放非托管资源。因此,IDisposable的引入就是为了填补这一空白。

1. IDisposable接口的基本用法

IDisposable只有一个方法:Dispose(),调用它时应释放所有占用的非托管资源。

示例:实现IDisposable接口

public class FileLogger : IDisposable
{
    private FileStream _fileStream;
    private bool _disposed = false;
    public FileLogger(string filePath)
    {
        _file7Stream = new FileStream(filePath, FileMode.Append);
    }
    public void Log(string message)
    {
        if (_disposed)
            throw new ObjectDisposedException(nameof(FileLogger));
        byte[] data = Encoding.UTF8.GetBytes(message + "\n");
        _fileStream.Write(data, 0, data.Length);
    }
    public void Dispose()
    {
        Dispose(true);
        GC.SuppressFinalize(this); // 避免重复调用析构函数
    }
    protected virtual void Dispose(bool disposing)
    {
        if (_disposed) return;
        if (disposing)
        {
            // 释放托管资源
            _fileStream?.Dispose();
        }
        // 这里可以释放非托管资源(如果有)
        _disposed = true;
    }
}

上面代码的关键点:

Dispose(bool disposing):标准的Dispose模式写法,区分是否由用户显式调用。 GC.SuppressFinalize(this):告诉GC不需要再调用析构函数,避免资源二次释放。 _disposed标志位:防止多次释放资源。

2. using语句:自动调用Dispose

C#提供了using语句,用于确保对象使用完毕后自动调用Dispose方法,即使发生异常也能安全释放资源。

示例:使用using语句

using (var logger = new FileLogger("log.txt"))
{
    logger.Log("程序开始运行");
    logger.Log("处理数据中...");
} // 在这里,logger.Dispose() 自动被调用

等价于以下try-finally结构:

FileLogger logger = new FileLogger("log.txt");
try
{
    logger.Log("程序开始运行");
}
finally
{
    logger?.Dispose();
}

using语句更简洁、安全,推荐优先使用。

3. 带继承的Dispose模式(可选)

如果类可能被继承,并且子类也需要释放资源,应将Dispose设计为虚方法,允许重写。

public class BaseResource : IDisposable
{
    private bool _disposed = false;
    public void Dispose()
    {
        Dispose(true);
        GC.SuppressFinalize(this);
    }
    protected virtual void Dispose(bool disposing)
    {
        if (!_disposed && disposing)
        {
            // 释放资源
        }
        _disposed = true;
    }
}
public class DerivedResource : BaseResource
{
    private IntPtr _unmanagedHandle; // 模拟非托管资源
    protected override void Dispose(bool disposing)
    {
        if (!disposed)
        {
            if (disposing)
            {
                // 释放托管资源
            }
            // 释放非托管资源
            if (_unmanagedHandle != IntPtr.Zero)
            {
                Marshal.FreeHGlobal(_unmanagedHandle);
                _unmanagedHandle = IntPtr.Zero;
            }
            disposed = true;
        }
        base.Dispose(disposing);
    }
}

注意:子类应在最后调用base.Dispose(disposing),保证释放顺序正确。

4. 析构函数(~ClassName)与Dispose配合(较少用)

如果类直接持有非托管资源,可以添加析构函数作为“安全网”,以防用户忘记调用Dispose。

~FileLogger()
{
    Dispose(false);
}

但要注意:

析构函数由GC调用,时间不可控。 仅作为后备机制,不能替代显式Dispose。 大多数情况下,使用SafeHandle等封装类即可,无需自己写析构函数。

基本上就这些。只要涉及文件、流、数据库连接、GDI+对象等资源,记得实现IDisposable,并配合using语句使用,就能有效避免资源泄漏。

相关推荐