在開發各種應用程式時,我們經常需要對文件系統中的文件或文件夾進行實時監測,以便在文件內容改變、文件被創建或刪除時能夠及時做出反應。在 C# 中,System.IO.FileSystemWatcher 類為我們提供了這樣一個強大的功能。 一、引入 FileSystemWatcher 類 首先,在項目中 ...
在開發各種應用程式時,我們經常需要對文件系統中的文件或文件夾進行實時監測,以便在文件內容改變、文件被創建或刪除時能夠及時做出反應。在 C# 中,System.IO.FileSystemWatcher 類為我們提供了這樣一個強大的功能。
一、引入 FileSystemWatcher 類
首先,在項目中引入 System.IO 命名空間,這是使用 FileSystemWatcher 類的前提:
using System.IO;
二、創建並配置 FileSystemWatcher 實例
下麵是一個簡單的例子,展示瞭如何創建一個 FileSystemWatcher 實例並設置其監視的目錄、事件類型以及事件處理函數:
public class FileFolderMonitor
{
private FileSystemWatcher _fileWatcher;
public void StartMonitoring(string directoryPath)
{
// 創建 FileSystemWatcher 實例
_fileWatcher = new FileSystemWatcher();
// 設置要監視的目錄路徑
_fileWatcher.Path = directoryPath;
// 設置要監視的更改類型(例如:修改、創建、刪除)
_fileWatcher.NotifyFilter = NotifyFilters.LastWrite | NotifyFilters.FileName | NotifyFilters.DirectoryName;
// 添加事件處理程式
_fileWatcher.Changed += OnChanged;
_fileWatcher.Created += OnChanged;
_fileWatcher.Deleted += OnChanged;
_fileWatcher.Renamed += OnRenamed;
// 開啟事件監聽
_fileWatcher.EnableRaisingEvents = true;
Console.WriteLine($"已開始監視文件夾: {directoryPath}");
}
private void OnChanged(object source, FileSystemEventArgs e)
{
Console.WriteLine($"文件或文件夾發生變更: {e.FullPath},事件類型: {e.ChangeType}");
}
private void OnRenamed(object source, RenamedEventArgs e)
{
Console.WriteLine($"文件或文件夾被重命名: 舊路徑 {e.OldFullPath} -> 新路徑 {e.FullPath}");
}
public void StopMonitoring()
{
if (_fileWatcher != null)
{
// 停止引發事件
_fileWatcher.EnableRaisingEvents = false;
// 清理資源
_fileWatcher.Dispose();
_fileWatcher = null;
Console.WriteLine("已停止監視文件夾");
}
}
}
三、使用與註意事項
-
在上述代碼中,我們通過調用 StartMonitoring 方法啟動了對指定目錄的監視,並且在文件或子目錄發生變化時觸發相應的事件處理器。
-
NotifyFilter 屬性用來定義需要監聽的具體事件類型,如最後寫入時間、文件名和目錄名的變化等。
-
Changed、Created、Deleted 和 Renamed 四個事件分別對應於文件或文件夾的內容更改、新建、刪除和重命名操作。
-
註意事項:
-
FileSystemWatcher 類並不能保證事件的即時性或順序性,尤其是在大量併發文件操作的情況下,可能會合併或延遲觸發事件。
-
使用 FileSystemWatcher 時應確保合理處理資源,特別是當不再需要監視時,應及時調用 Dispose 方法釋放資源。
-
總結來說,System.IO.FileSystemWatcher 是實現文件系統實時監控的強大工具,只需簡單配置和事件處理,就能讓我們的應用程式具備靈敏響應文件系統變化的能力。
四、課外探索,彈出文件選擇框
public static string SelectFolder(string description = "請選擇一個文件夾:", Environment.SpecialFolder rootFolder = Environment.SpecialFolder.MyComputer)
{
using (FolderBrowserDialog folderDialog = new FolderBrowserDialog())
{
folderDialog.Description = description;
folderDialog.RootFolder = rootFolder;
if (folderDialog.ShowDialog() == DialogResult.OK)
{
return folderDialog.SelectedPath;
}
}
return string.Empty;
}