C# FileSystemWatcher使用说明

1.常用的几个基本属性：

(1) Path ：设置要监视的目录的路径。

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

(3) Filter ：设置筛选字符串，用于确定在目录中监视哪些类型的文件。例子：“*.zip|*.rar”

(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 对象（Changed,Created,Deleted事件对象）：

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

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

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

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

(6) RenamedEventArgs 对象（Renamed事件对象）：

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

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

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

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

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

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

示例代码

using System;
using System.IO;

namespace MyNamespace
{
    class MyClassCS
    {
        static void Main()
        {
            using var watcher = new FileSystemWatcher(@"C:\path\to\folder");

            watcher.NotifyFilter = NotifyFilters.Attributes
                                 | NotifyFilters.CreationTime
                                 | NotifyFilters.DirectoryName
                                 | NotifyFilters.FileName
                                 | NotifyFilters.LastAccess
                                 | NotifyFilters.LastWrite
                                 | NotifyFilters.Security
                                 | NotifyFilters.Size;

            watcher.Changed += OnChanged;
            watcher.Created += OnCreated;
            watcher.Deleted += OnDeleted;
            watcher.Renamed += OnRenamed;
            watcher.Error += OnError;

            watcher.Filter = "*.txt";
            watcher.IncludeSubdirectories = true;
            watcher.EnableRaisingEvents = true;

            Console.WriteLine("Press enter to exit.");
            Console.ReadLine();
        }

        private static void OnChanged(object sender, FileSystemEventArgs e)
        {
            if (e.ChangeType != WatcherChangeTypes.Changed)
            {
                return;
            }
            Console.WriteLine($"Changed: {e.FullPath}");
        }

        private static void OnCreated(object sender, FileSystemEventArgs e)
        {
            string value = $"Created: {e.FullPath}";
            Console.WriteLine(value);
        }

        private static void OnDeleted(object sender, FileSystemEventArgs e) =>
            Console.WriteLine($"Deleted: {e.FullPath}");

        private static void OnRenamed(object sender, RenamedEventArgs e)
        {
            Console.WriteLine($"Renamed:");
            Console.WriteLine($"    Old: {e.OldFullPath}");
            Console.WriteLine($"    New: {e.FullPath}");
        }

        private static void OnError(object sender, ErrorEventArgs e) =>
            PrintException(e.GetException());

        private static void PrintException(Exception? ex)
        {
            if (ex != null)
            {
                Console.WriteLine($"Message: {ex.Message}");
                Console.WriteLine("Stacktrace:");
                Console.WriteLine(ex.StackTrace);
                Console.WriteLine();
                PrintException(ex.InnerException);
            }
        }
    }
}

 

参考msdn地址：https://docs.microsoft.com/en-us/dotnet/api/system.io.filesystemwatcher?view=net-5.0