C#中FileSystemWatcher的使用教程

我将详细讲解如何使用C#中的FileSystemWatcher来监听文件系统的改变。本教程将包含以下内容：

1. 简介：FileSystemWatcher是什么以及如何使用它
2. 监听文件夹和文件变化的方式
3. 示例说明

1. 简介

FileSystemWatcher是.NET Framework中的一个类，它以异步的方式监听文件和目录的变化。它可以监控以下变化：

• 文件或文件夹的创建
• 文件或文件夹的更名
• 文件或文件夹的删除
• 文件的大小、属性或最后修改日期的更改

FileSystemWatcher是非常有用的工具，可以用来监控您的应用程序的日志文件、配置文件等，从而实时地处理数据。

2. 监听文件夹和文件变化的方式

在使用FileSystemWatcher之前，需要创建一个实例并设置要监控的目录和文件以及要监控的变化类型。下面是一些常见的用法示例：

// 创建实例
FileSystemWatcher watcher = new FileSystemWatcher();

// 设置要监控的目录
watcher.Path = @"D:\example";

// 设置要监控的文件类型，此处可以设置多项，如 "*.txt;*.xml"
watcher.Filter = "*.txt";

// 监听事件，如创建、删除、更改名称、修改等
watcher.NotifyFilter = NotifyFilters.LastAccess | NotifyFilters.LastWrite
    | NotifyFilters.FileName | NotifyFilters.DirectoryName;

// 添加事件处理程序
watcher.Created += new FileSystemEventHandler(OnCreated);
watcher.Deleted += new FileSystemEventHandler(OnDeleted);
watcher.Renamed += new RenamedEventHandler(OnRenamed);
watcher.Changed += new FileSystemEventHandler(OnChanged);

// 开始监控
watcher.EnableRaisingEvents = true;

上述代码设置了要监控的目录为"D:\example"，并且只监控.txt类型的文件。监听事件包括创建、删除、重命名和更改。当需要处理这些事件时，可以自定义四个事件处理程序如下：

private static void OnCreated(object source, FileSystemEventArgs e)
{
    Console.WriteLine("文件:{0} {1}", e.FullPath, e.ChangeType);
}

private static void OnDeleted(object source, FileSystemEventArgs e)
{
    Console.WriteLine("文件:{0} {1}", e.FullPath, e.ChangeType);
}

private static void OnRenamed(object source, RenamedEventArgs e)
{
    Console.WriteLine("文件:{0} 重命名为:{1} {2}", e.OldFullPath, e.FullPath, e.ChangeType);
}

private static void OnChanged(object source, FileSystemEventArgs e)
{
    Console.WriteLine("文件:{0} {1}", e.FullPath, e.ChangeType);
}

在这些事件处理程序中，您可以编写自定义代码来处理文件或文件夹的变化事件。例如，您可以将所有新文件的信息写入数据库中，或者更新监控的UI。

3. 示例说明

以下是两个例子，分别演示了如何使用FileSystemWatcher监视文件的创建和修改。

示例1：监视文件的创建

下面的示例代码演示了如何使用FileSystemWatcher监视新文件的创建。当新文件被创建时，程序将在控制台上打印一条消息。

public static void Main()
{
    FileSystemWatcher watcher = new FileSystemWatcher();

    watcher.Path = @"D:\example";
    watcher.Filter = "*.txt";
    watcher.NotifyFilter = NotifyFilters.FileName;

    watcher.Created += (sender, e) =>
    {
        Console.WriteLine($"新文件 ({e.Name}) 于 {DateTime.Now} 创建");
    };
    watcher.EnableRaisingEvents = true;

    Console.WriteLine("按任意键退出。");
    Console.ReadKey();
}

在这个示例中，我们只监听了新文件的创建事件。当事件发生时，将会在控制台上打印一条信息。以下是输出示例：

新文件 (example.txt) 于 2020/11/16 20:30:42 创建

示例2：监视文件的修改

下面的示例代码演示了如何使用FileSystemWatcher监视文件修改事件。当指定的文件被修改时，程序将在控制台上打印一条消息。

public static void Main()
{
    FileSystemWatcher watcher = new FileSystemWatcher();

    watcher.Path = @"D:\example";
    watcher.Filter = "example.txt";
    watcher.NotifyFilter = NotifyFilters.LastWrite;

    watcher.Changed += (sender, e) =>
    {
        Console.WriteLine($"文件 ({e.Name}) 于 {DateTime.Now} 修改");
    };
    watcher.EnableRaisingEvents = true;

    Console.WriteLine("按任意键退出。");
    Console.ReadKey();
}

在这个示例中，我们只监听了文件修改事件。当文件发生变化时，将会在控制台上打印一条信息。以下是输出示例：

文件 (example.txt) 于 2020/11/16 20:30:42 修改

结语

以上就是C#中FileSystemWatcher的使用教程的完整攻略。对于不同的应用程序，您需要根据具体需求去设置和处理FileSystemWatcher所观察的目录和文件。祝您使用愉快！