C# FileSystemWatcher使用方法说明

作者：袖梨 2022-06-25

FileSystemWatcher控件主要功能：
监控指定文件或目录的文件的创建、删除、改动、重命名等活动。可以动态地定义需要监控的文件类型及文件属性改动的类型。

1.常用的几个基本属性：
(1) Path ：设置要监视的目录的路径。

(2) IncludeSubdirectories ：设置是否级联监视指定路径中的子目录。

(3) Filter ：设置筛选字符串，用于确定在目录中监视哪些类型的文件。

(4) NotifyFilter ：设置文件的哪些属性的变动会触发 Changed事件，同时监控多个属性变动可以按“或”组合。（默认值为 NotifyFilter.LastWrite | NotifyFilter.FileName | NotifyFilter.DirectoryName 组合）

子项： Attributes           -- 文件或文件夹的属性。
             CreationTime   -- 文件或文件夹的创建时间。
             DirectoryName -- 目录名。（常用）
             FileName          -- 文件名。（常用）
             LastAccess       -- 文件或文件夹上一次打开的日期。
             LastWrite           -- 上一次向文件或文件夹写入内容的日期。
             Security              -- 文件或文件夹的安全设置。
             Size                    --   文件或文件夹的大小。（常用）

(5) EnableRaisingEvents ：设置是否开始监控。（默认为false）

2.常用事件：
(1) Changed ：当更改文件和目录时发生，可以通过NotifyFilter属性设置触发该事件的需要文件更改的属性。

(2) Created ：当创建文件和目录时发生。

(3) Deleted ：删除文件或目录时发生。

(4) Renamed ：重命名文件或目录时发生。

(5) FileSystemEventArgs 对象：

成员：Name：获取受影响的文件或目录的名称。注意：如果是级联监控子目录的话，该值为从监控目录的下个目录到受影响的文件的路径，而不只是受影响的文件名。

FullPath ：获取受影响的文件或目录的完全限定的路径。

ChangeType ：获取受影响的文件或目录的发生的事件类型。

            子项：All                 -- 文件或文件夹的创建、删除、更改或重命名。
                       Changed     -- 文件或文件夹的更改。更改的类型包括大小、属性、安全设置、最近写入时间和最近访问时间方面的更改。
                       Created       -- 文件或文件夹的创建。
                       Deleted       -- 文件或文件夹的删除。
                       Renamed   -- 文件或文件夹的重命名。

(6) RenamedEventArgs 对象：

成员：Name：获取受影响的文件或目录的新名称。

OldName ：获取受影响的文件或目录的旧名称。

FullPath ：获取受影响的文件或目录的完全限定的路径。

OldFullPath ：获取受影响的文件或目录的前一个完全限定的路径。

ChangeType ：获取受影响的文件或目录的发生的事件类型。

实例

代码如下

复制代码

private delegate void setLogTextDelegate(FileSystemEventArgs e); //声明传递FileSystemEventArgs对象的委托，用于文件Created，Deleted和Changed变动时更新UI界面。

private delegate void renamedDelegate(RenamedEventArgs e); //声明传递RenamedEventArgs对象的委托，用于文件Renamed时更新UI界面。

FileSystemWatcher fsw= new FileSystemWatcher();

fsw.Path = “C:”; //设置监控的文件目录

fsw.IncludeSubdirectories = true; //设置监控C盘目录下的所有子目录

fsw.Filter = "*.txt|*.doc|*.jpg"; //设置监控文件的类型

fsw.NotifyFilter = NotifyFilters.FileName | NotifyFilters.DirectoryName | NotifyFilters.Size; //设置文件的文件名、目录名及文件的大小改动会触发Changed事件

fsw.Created += new FileSystemEventHandler(this.fileSystemWatcher_EventHandle); //绑定事件触发后处理数据的方法。

fsw.Deleted += new FileSystemEventHandler(this.fileSystemWatcher_EventHandle);

fsw.Changed += new FileSystemEventHandler(this.fileSystemWatcher_EventHandle);

fsw.Renamed += new RenamedEventHandler(this.fileSystemWatcher_Renamed); //重命名事件与增删改传递的参数不一样。

fsw.EnableRaisingEvents = true; //启动监控

private void fileSystemWatcher_EventHandle(object sender, FileSystemEventArgs e) //文件增删改时被调用的处理方法
{
     if (this.listView1.InvokeRequired) //判断是否跨线程
      {
           this.listView1.Invoke(new setLogTextDelegate(setLogText), new object[] { e });   //使用委托将方法封送到UI主线程处理
      }
}

private void fileSystemWatcher_Renamed(object sender,RenamedEventArgs e)   //文件重命名时被调用的处理方法
{
      if (this.listView1.InvokeRequired) //判断是否跨线程
       {
           this.listView1.Invoke(new renamedDelegate(setRenamedLogText), new object[] { e }); //使用委托将方法封送到UI主线程处理
       }
}

private void setLogText(FileSystemEventArgs e) //更新UI界面
{
ListViewItem lvi = new ListViewItem();

lvi.SubItems.Add(e.Name); //受影响的文件名

lvi.SubItems.Add(e.ChangeType.ToString()); //受影响文件的变动类型(可能为Created、Changed、Deleted）

lvi.SubItems.Add(e.FullPath); //受影响的文件完整路径

this.listView1.Items.Add(lvi);
}

private void setRenamedLogText(RenamedEventArgs e) //更新UI界面
{
ListViewItem lvi = new ListViewItem();

lvi.SubItems.Add(e.OldName); //受影响的文件的原名

lvi.SubItems.Add(e.ChangeType.ToString()); //受影响的文件的改动类型（Rename）

lvi.SubItems.Add(e.Name); //受影响的文件的新名

lvi.SubItems.Add(e.OldFullPath); //受影响的文件的原路径

lvi.SubItems.Add(e.FullPath); //受影响的文件的完整路径（其实和原路径一样）

this.fileEventLog_lvw.Items.Add(lvi);