C#VB.NET中实现可靠的文件监控(新建、删除、改名、内容修改等事件的准确捕获)

VB.NET中实现可靠的文件监控(包括新建、删除、改名、内容修改等事件的准确捕获),直接使用ReadDirectoryChangesW API 容易出现事件错乱(尤其是重命名和移动场景),因为该 API 本身对复杂操作的事件通知不够直观。

推荐以下几种成熟的 NuGet 包或组件,它们封装了底层逻辑,能更准确地处理文件系统事件:

1. FileSystemWatcher(.NET 内置类,无需额外安装)

.NET Framework/.NET Core 自带的System.IO.FileSystemWatcher类,本质上封装了ReadDirectoryChangesW,但做了一定的事件处理优化。虽然在极端场景(如高频操作)下仍可能有事件重复或顺序问题,但对于大多数常规场景足够可靠。

优势 :无需额外依赖,原生支持。不足:重命名操作会拆分为 "删除旧文件 + 创建新文件" 两个事件,需手动关联(可通过临时缓存文件名和时间戳判断)。

基本用法

vbnet 复制代码
Imports System.IO

Public Class FileMonitor
    Private WithEvents watcher As New FileSystemWatcher()

    Public Sub StartMonitoring(path As String)
        watcher.Path = path
        watcher.IncludeSubdirectories = True ' 监控子目录
        ' 监控的事件类型
        watcher.NotifyFilter = NotifyFilters.FileName Or NotifyFilters.DirectoryName Or NotifyFilters.LastWrite
        watcher.EnableRaisingEvents = True
    End Sub

    ' 文件/目录创建
    Private Sub watcher_Created(sender As Object, e As FileSystemEventArgs) Handles watcher.Created
        Console.WriteLine($"创建: {e.FullPath}")
    End Sub

    ' 文件/目录删除
    Private Sub watcher_Deleted(sender As Object, e As FileSystemEventArgs) Handles watcher.Deleted
        Console.WriteLine($"删除: {e.FullPath}")
    End Sub

    ' 文件/目录重命名(需处理OldFullPath和FullPath)
    Private Sub watcher_Renamed(sender As Object, e As RenamedEventArgs) Handles watcher.Renamed
        Console.WriteLine($"重命名: {e.OldFullPath} -> {e.FullPath}")
    End Sub

    ' 文件内容修改(基于LastWrite时间)
    Private Sub watcher_Changed(sender As Object, e As FileSystemEventArgs) Handles watcher.Changed
        Console.WriteLine($"修改: {e.FullPath}")
    End Sub
End Class

2. AlphaFS(推荐用于复杂场景)

NuGet 包AlphaFS(搜索安装)一个增强型文件系统操作库,封装了底层 API 并解决了FileSystemWatcher的诸多缺陷,尤其对重命名、移动、网络路径(UNC)等场景支持更可靠。

优势

  • 重命名事件准确捕获(不会拆分为删除 + 创建)。
  • 支持更多事件细节(如文件大小变化、属性变化)。
  • 处理网络路径和长路径(超过 260 字符)更稳定。

基本用法

vb

复制代码
Imports Alphaleonis.Win32.Filesystem
Imports Alphaleonis.Win32.Filesystem.Watcher

Public Class AlphaFSMonitor
    Private WithEvents watcher As New FileSystemWatcher()

    Public Sub StartMonitoring(path As String)
        watcher.Path = path
        watcher.IncludeSubdirectories = True
        watcher.NotifyFilter = NotifyFilters.FileName Or NotifyFilters.DirectoryName Or NotifyFilters.LastWrite
        watcher.EnableRaisingEvents = True
    End Sub

    ' 重命名事件(准确捕获)
    Private Sub watcher_Renamed(sender As Object, e As RenamedEventArgs) Handles watcher.Renamed
        Console.WriteLine($"重命名: {e.OldFullPath} -> {e.FullPath}")
    End Sub

    ' 其他事件(创建、删除、修改)与FileSystemWatcher类似
End Class

3. DirectoryMonitor(轻量级监控库)

NuGet 包DirectoryMonitor一个轻量级库,专注于文件系统监控,通过对比快照和事件结合的方式减少误报,适合对事件准确性要求高的场景。

优势

  • 内置事件去重和关联逻辑(如自动识别重命名而非删除 + 创建)。
  • 支持批量操作处理,减少高频事件的干扰。

基本用法

vb

vbnet 复制代码
Imports DirectoryMonitor

Public Class DirMonitorExample
    Private monitor As New DirectoryMonitor()

    Public Sub Start(path As String)
        monitor.AddDirectory(path, recursive:=True)
        AddHandler monitor.FileCreated, AddressOf OnFileCreated
        AddHandler monitor.FileDeleted, AddressOf OnFileDeleted
        AddHandler monitor.FileRenamed, AddressOf OnFileRenamed
        AddHandler monitor.FileChanged, AddressOf OnFileChanged
        monitor.Start()
    End Sub

    Private Sub OnFileRenamed(sender As Object, e As FileRenamedEventArgs)
        Console.WriteLine($"重命名: {e.OldPath} -> {e.NewPath}")
    End Sub

    ' 其他事件处理方法...
End Class

4. FileSystemWatcherEx(扩展版)

NuGet 包FileSystemWatcherExFileSystemWatcher的扩展,增加了事件合并、重命名识别、错误重试等功能,适合需要兼容旧系统但又要提升可靠性的场景。

总结推荐:

  • 简单场景直接使用.NET 内置的FileSystemWatcher,通过手动逻辑(如缓存)处理重命名关联。
  • 复杂场景(重命名 / 移动关键) :优先选择AlphaFS,成熟稳定,对边缘情况处理更好。
  • 轻量需求DirectoryMonitor,配置简单,事件准确性高。

这些库均通过封装和优化底层 API,解决了ReadDirectoryChangesW直接使用时的事件错乱问题,可根据项目复杂度选择。

编辑分享

目录

[1. FileSystemWatcher(.NET 内置类,无需额外安装)](#1. FileSystemWatcher(.NET 内置类,无需额外安装))

[2. AlphaFS(推荐用于复杂场景)](#2. AlphaFS(推荐用于复杂场景))

[3. DirectoryMonitor(轻量级监控库)](#3. DirectoryMonitor(轻量级监控库))

[4. FileSystemWatcherEx(扩展版)](#4. FileSystemWatcherEx(扩展版))

总结推荐:


如何使用FileSystemWatcher类实现文件监控?

除了FileSystemWatcher类,还有哪些方法可以实现文件监控?

FileSystemWatcher类在监控文件时如何避免事件重复?

相关推荐
cfm_291430 分钟前
Spring事务
数据库·spring·oracle
跨境数据猎手4 小时前
京东开放平台商品详情接口(jd.item_get):签名、缓存与批量采集
java·spring·缓存
czhc11400756634 小时前
2026-09-03 博客:配置与密码 · 合并代码 · 超时排查
c#
霸道流氓气质5 小时前
Spring AI提示词模板与动态变量替换
java·python·spring
Lost of 程序猿6 小时前
.NET 线程安全集合与并发数据结构深度实战:从 lock 到无锁
数据结构·安全·.net
Whyn6 小时前
Servlet 学习笔记
spring
ofoxcoding6 小时前
Claude Fable 5.1 API 接入指南:模型标识、五级定价策略、effort 参数与缓存 TTL 配置详解
java·spring·缓存·ai
格林威6 小时前
C#图像夜间识别率提升:使用OpenCvSharp和Halcon融合DeepSORT实现复杂场景下准确识别
开发语言·人工智能·数码相机·机器学习·计算机视觉·c#·视觉检测
摇滚侠7 小时前
《SpringBoot 3:入门与应用实战》第 12 章 JDBC 与事务 Spring Framework 的事务管理 阅读笔记 34
spring boot·笔记·spring
曹牧8 小时前
C#:线程间操作无效,不是从创建控件线程访问
开发语言·c#