C#判断本地文件是否处于打开状态的方法

追风的人

发布时间：2026-10-13 | 6人浏览过

原创

本文讲述如何在C#中判断本地文件是否被其他程序打开（即存在独占连接）。利用 Windows `kernel32.dll` API 进行轻量级检测，避免多线程或进程间文件读写时的“文件正在使用中”异常。

原理与目标

操作系统在同一时刻通常只允许一个流对特定文件建立独占连接。在频繁进行文件读写的程序中，直接操作未检查的文件极易导致异常。_lopen 函数可用于尝试以指定共享权限打开文件，若返回错误指针则表示文件已被锁定。

准备条件

C# 运行环境（.NET Framework 或 .NET Core/5+）
需要引用 System.Runtime.InteropServices 命名空间
拥有目标文件的访问权限

实现步骤

第1步：创建检测工具类

目的：封装底层调用逻辑，对外提供简单的整数状态返回值。

说明：该类包含以下关键定义：

DllImport("kernel32.dll")：引入外部动态链接库。
_lopen：尝试打开文件的核心函数。
CloseHandle：释放资源。
HFILE_ERROR：表示操作的错误状态标识。

using System;
using System.IO;
using System.Runtime.InteropServices;

public class FileStatus
{
    // 声明 Windows API 函数
    [DllImport("kernel32.dll")]
    private static extern IntPtr _lopen(string lpPathName, int iReadWrite);
    
    [DllImport("kernel32.dll")]
    private static extern bool CloseHandle(IntPtr hObject);

    // 常量定义
    private const int OF_READWRITE = 2;        // 读写模式
    private const int OF_SHARE_DENY_NONE = 0x40; // 不拒绝任何共享访问
    private static readonly IntPtr HFILE_ERROR = new IntPtr(-1); // 错误指针

    /// <summary>
    /// 判断文件是否被占用
    /// </summary>
    /// <param name="fileFullName">文件绝对路径</param>
    /// <returns>0: 未被占用, 1: 已被占用, -1: 文件不存在</returns>
    public static int FileIsOpen(string fileFullName)
    {
        if (!File.Exists(fileFullName))
        {
            return -1;
        }
        
        // 尝试以无限制共享方式打开文件
        IntPtr handle = _lopen(fileFullName, OF_READWRITE | OF_SHARE_DENY_NONE);
        
        // 如果返回错误句柄，说明文件正被独占占用
        if (handle == HFILE_ERROR)
        {
            return 1;
        }
        
        // 释放句柄
        CloseHandle(handle);
        return 0;
    }
}

第2步：编写调用测试逻辑

目的：模拟真实场景，开启一个文件流并观察检测结果的变化。

入口：控制台应用程序 Main 方法。

动作：

构建测试文件路径（基于当前应用目录）。
使用 FileStream 和 BinaryReader 保持文件打开状态。
调用 FileStatus.FileIsOpen 查看状态。
关闭阅读器再次检测。

class Program
{
    static void Main(string[] args)
    {
        // 获取应用程序基础路径
        string testFilePath = AppDomain.CurrentDomain.SetupInformation.ApplicationBase + @"testOpen.txt";

        try
        {
            // 模拟文件被打开的场景
            FileStream fs = new FileStream(testFilePath, FileMode.OpenOrCreate, FileAccess.Read);
            BinaryReader br = new BinaryReader(fs);
            br.Read();

            Console.WriteLine("文件被打开");
            int result = FileStatus.FileIsOpen(testFilePath);
            Console.WriteLine(result); // 预期输出: 1

            // 清理资源
            br.Close();
            fs.Close();

            Console.WriteLine("文件被关闭");
            result = FileStatus.FileIsOpen(testFilePath);
            Console.WriteLine(result); // 预期输出: 0
        }
        catch (Exception ex)
        {
            Console.WriteLine($"发生错误: {ex.Message}");
        }

        Console.ReadLine();
    }
}