C#轻松实现Winform监控文件夹变化以及监控文件新增、修改、删除、重命名等操作保姆级详细教程

一、前言

在开发应用程序时，我们可能会因为场景的需要，要对文件系统中的文件或文件夹进行实时监测，以便在文件内容改变、文件被创建、删除或重命名时能够及时做出反应。

今天，我将为大家介绍完整的操作流程，让你轻松实现监控文件/文件夹变化的功能。

本教程是以Winform为例，但并不代表监听文件夹的功能只能Winform才能用，只要C#代码能运行的环境和开发方式，都能用。

二、FileSystemWatcher 类

在 C# 中，System.IO.FileSystemWatcher 类为我们提供了这样一个强大的功能。

因此我们在项目中直接使用该类来实现功能即可，值得注意的是，该类在 System.IO 命名空间下，大家引用的时候可别引错了。

三、FolderBrowserDialog 类

在 C# 中，System.Windows.Form.FolderBrowserDialog 类可给Winform程序提供选择文件夹的功能，这里我们使用该类进行选择文件夹的操作。

当然，如果你非要手动复制文件夹的路径，也不是不可以。

四、具体操作

1.设置监听文件夹

我们新建一个窗体，将它命名为：MainWindow.cs，然后添加一个文本框控件和一个按钮控件。

在按钮的点击事件里面写上如下代码：

FolderBrowserDialog dialog = new FolderBrowserDialog();
dialog.Multiselect = false;
dialog.ShowDialog();

if (dialog.SelectedPaths != null && dialog.SelectedPaths.Length > 0)
{
    //赋值到文本框
    this.txtPath.Text = dialog.SelectedPaths[0].Trim();

}

这样文本框就会在每次选择文件夹之后，被赋值一个文件夹的路径。

2.订阅变更事件

public partial class MainWindow : Form
{
    private FileSystemWatcher? _fileWatcher;

    //这里的 directoryPath，就是上一步选择的文件夹路径
    public void StartMonitoring(string directoryPath)
    {
        // 创建 FileSystemWatcher 实例
        _fileWatcher = new FileSystemWatcher();
 
        // 设置要监视的目录路径
        _fileWatcher.Path = directoryPath;
 
        // 设置要监视的更改类型（例如：修改、创建、删除）
        _fileWatcher.NotifyFilter = NotifyFilters.LastWrite | NotifyFilters.FileName | NotifyFilters.DirectoryName;
 
        // 添加事件处理程序
        _fileWatcher.Changed += OnChanged;
        _fileWatcher.Created += OnChanged;
        _fileWatcher.Deleted += OnChanged;
        _fileWatcher.Renamed += OnRenamed;
 
        // 开启事件监听
        _fileWatcher.EnableRaisingEvents = true;
 
        Console.WriteLine($"已开始监视文件夹: {directoryPath}");
    }
 
    private void OnChanged(object source, FileSystemEventArgs e)
    {
        Console.WriteLine($"文件或文件夹发生变更: {e.FullPath}，事件类型: {e.ChangeType}");
    }
 
    private void OnRenamed(object source, RenamedEventArgs e)
    {
        Console.WriteLine($"文件或文件夹被重命名: 旧路径 {e.OldFullPath} -> 新路径 {e.FullPath}");
    }
 
    public void StopMonitoring()
    {
        if (_fileWatcher != null)
        {
            // 停止引发事件
            _fileWatcher.EnableRaisingEvents = false;
 
            // 清理资源
            _fileWatcher.Dispose();
            _fileWatcher = null;
 
            Console.WriteLine("已停止监视文件夹");
        }
    }
}

在上述代码中，我们通过调用 StartMonitoring 方法启动了对指定目录的监视，并且在文件或子目录发生变化时触发相应的事件处理器。

NotifyFilter 属性用来定义需要监听的具体事件类型，如最后写入时间、文件名和目录名的变化等。

Changed、Created、Deleted 和 Renamed 四个事件分别对应于文件或文件夹的内容更改、新建、删除和重命名操作。

3.注意事项

FileSystemWatcher 类并不能保证事件的即时性或顺序性，尤其是在大量并发文件操作的情况下，可能会合并或延迟触发事件。

使用 FileSystemWatcher 时应确保合理处理资源，特别是当不再需要监视时，应及时调用 Dispose 方法释放资源。

总的来说，System.IO.FileSystemWatcher 是实现文件系统实时监控的强大工具，只需简单配置和事件处理，就能让我们的应用程序具备灵敏响应文件系统变化的能力。

好了，本次教程到这里就结束啦，感谢大家观看~

都看到这里了，各位帅哥/美女，不管有用没用，都帮忙点个赞呗，❤️谢谢~

Author

吴所畏惧 2024-12-18