FileSystemWatcher用法详解
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 :获取受影响的文件或目录的发生的事件类型。
子项:All -- 文件或文件夹的创建、删除、更改或重命名。
Changed -- 文件或文件夹的更改。更改的类型包括大小、属性、安全设置、最近写入时间和最近访问时间方面的更改。
Created -- 文件或文件夹的创建。
Deleted -- 文件或文件夹的删除。
Renamed -- 文件或文件夹的重命名。
1 private delegate void setLogTextDelegate(FileSystemEventArgs e); //声明传递FileSystemEventArgs对象的委托,用于文件Created,Deleted和Changed变动时更新UI界面。 2 3 private delegate void renamedDelegate(RenamedEventArgs e); //声明传递RenamedEventArgs对象的委托,用于文件Renamed时更新UI界面。 4 5 FileSystemWatcher fsw= new FileSystemWatcher(); 6 7 fsw.Path = “C:\”; //设置监控的文件目录 8 9 fsw.IncludeSubdirectories = true; //设置监控C盘目录下的所有子目录 10 11 fsw.Filter = "*.txt|*.doc|*.jpg"; //设置监控文件的类型 12 13 fsw.NotifyFilter = NotifyFilters.FileName | NotifyFilters.DirectoryName | NotifyFilters.Size; //设置文件的文件名、目录名及文件的大小改动会触发Changed事件 14 15 fsw.Created += new FileSystemEventHandler(this.fileSystemWatcher_EventHandle); //绑定事件触发后处理数据的方法。 16 17 fsw.Deleted += new FileSystemEventHandler(this.fileSystemWatcher_EventHandle); 18 19 fsw.Changed += new FileSystemEventHandler(this.fileSystemWatcher_EventHandle); 20 21 fsw.Renamed += new RenamedEventHandler(this.fileSystemWatcher_Renamed); //重命名事件与增删改传递的参数不一样。 22 23 fsw.EnableRaisingEvents = true; //启动监控 24 25 private void fileSystemWatcher_EventHandle(object sender, FileSystemEventArgs e) //文件增删改时被调用的处理方法 26 { 27 if (this.listView1.InvokeRequired) //判断是否跨线程 28 { 29 this.listView1.Invoke(new setLogTextDelegate(setLogText), new object[] { e }); //使用委托将方法封送到UI主线程处理 30 } 31 } 32 33 private void fileSystemWatcher_Renamed(object sender,RenamedEventArgs e) //文件重命名时被调用的处理方法 34 { 35 if (this.listView1.InvokeRequired) //判断是否跨线程 36 { 37 this.listView1.Invoke(new renamedDelegate(setRenamedLogText), new object[] { e }); //使用委托将方法封送到UI主线程处理 38 } 39 } 40 41 private void setLogText(FileSystemEventArgs e) //更新UI界面 42 { 43 ListViewItem lvi = new ListViewItem(); 44 45 lvi.SubItems.Add(e.Name); //受影响的文件名 46 47 lvi.SubItems.Add(e.ChangeType.ToString()); //受影响文件的变动类型(可能为Created、Changed、Deleted) 48 49 lvi.SubItems.Add(e.FullPath); //受影响的文件完整路径 50 51 this.listView1.Items.Add(lvi); 52 } 53 54 private void setRenamedLogText(RenamedEventArgs e) //更新UI界面 55 { 56 ListViewItem lvi = new ListViewItem(); 57 58 lvi.SubItems.Add(e.OldName); //受影响的文件的原名 59 60 lvi.SubItems.Add(e.ChangeType.ToString()); //受影响的文件的改动类型(Rename) 61 62 lvi.SubItems.Add(e.Name); //受影响的文件的新名 63 64 lvi.SubItems.Add(e.OldFullPath); //受影响的文件的原路径 65 66 lvi.SubItems.Add(e.FullPath); //受影响的文件的完整路径(其实和原路径一样) 67 68 this.fileEventLog_lvw.Items.Add(lvi); 69 70 }
重点:
1.、因为FileSystemWatcher类本身就是多线程的控件,也就是每实例化一个FileSystemWatcher自动就会创建一条线程。
2、我们需要利用委托进行跨线程更新UI界面,因为重命名事件传递的是RenameEventArgs对象,而创建、修改、删除事件传递的是FileEventArgs对象,所以需要声明两个委托。
3、如果需要同时监控多个文件(如监控系统全盘),只需要创建FileSystemWatcher数组,每个文件用一个FileSystemWatcher进行监控。
实例效果:
现放上以上C#文件监控的源码,希望对大家学习有帮助: