偵聽文件系統更改通知，并在目錄或目錄中的文件發生更改時引發事件。

命名空間:System.IO
程序集:System（在 system.dll 中）

繼承層次結構

C# 用法：

1public?class?FileSystemWatcher?:?Component,?ISupportInitialize

使用 FileSystemWatcher 監視指定目錄中的更改。可監視指定目錄中的文件或子目錄的更改。可以創建一個組件來監視本地計算機、網絡驅動器或遠程計算機上的文件。

若要通過文件擴展名監視所有文件中的更改，請將 Filter 屬性設置為空字符串 ("") 或使用通配符（“*.*”）。若要監視特定的文件，請將 Filter 屬性設置為該文件名。例如，若要監視文件 MyDoc.txt 中的更改，請將 Filter 屬性設置為“MyDoc.txt”。也可以監視特定類型文件中的更改。例如，若要監視文本文件中的更改，請將 Filter 屬性設置為“*.txt”。

可監視目錄或文件中的若干種更改。例如，可監視文件或目錄的 Attributes、LastWrite 日期和時間或 Size 方面的更改。通過將 NotifyFilter 屬性設置為 NotifyFilters 值之一來達到此目的。有關可監視的更改類型的更多信息，請參見 NotifyFilters。

可監視文件或目錄的重命名、刪除或創建。例如，若要監視文本文件的重命名，請將 Filter 屬性設置為“*.txt”，并使用為其參數指定的 Renamed 來調用 WaitForChanged 方法。

Windows 操作系統在 FileSystemWatcher 創建的緩沖區中通知組件文件發生更改。如果短時間內有很多更改，則緩沖區可能會溢出。這將導致組件失去對目錄更改的跟蹤，并且它將只提供一般性通知。使用 InternalBufferSize 屬性來增加緩沖區大小的開銷較大，因為它來自無法換出到磁盤的非頁面內存，所以應確保緩沖區大小適中（盡量小，但也要有足夠大小以便不會丟失任何文件更改事件）。若要避免緩沖區溢出，請使用 NotifyFilter 和 IncludeSubdirectories 屬性，以便可以篩選掉不想要的更改通知。

有關 FileSystemWatcher 的實例的初始屬性值列表，請參見 FileSystemWatcher 構造函數。

使用 FileSystemWatcher 類時，請注意以下事項。

• 不忽略隱藏文件。

• 在某些系統中，FileSystemWatcher 使用 8.3 短文件名格式報告文件更改。例如，對“LongFileName.LongExtension”的更改可能報告為“LongFi~.Lon”。

• 此類在應用于所有成員的類級別上包含一個鏈接要求和一個繼承要求。如果直接調用方或派生類不具有完全信任權限，則會引發 SecurityException。有關安全要求的詳細信息，請參見 鏈接要求。

復制和移動文件夾

事件和緩沖區大小

請注意，有幾個因素可能影響引發哪些文件系統更改事件，如下所述：

請注意，由于 Windows 操作系統的依賴項，當丟失某個事件或超出緩沖區大小時，FileSystemWatcher 不會引發 Error 事件。若要防止丟失事件，請遵從這些準則：

• 使用 InternalBufferSize 屬性增加緩沖區大小可以防止丟失文件系統更改事件。

• 避免監視帶有長文件名的文件。考慮使用較短的名稱進行重命名。

• 盡可能使事件處理代碼短小。

FileSystemWatcher 成員

公共構造函數

?	名稱	說明
	FileSystemWatcher	已重載。初始化 FileSystemWatcher 類的新實例。

公共屬性

?	名稱	說明
	Container?	獲取 IContainer，它包含 Component。（從 Component 繼承。）
	EnableRaisingEvents	獲取或設置一個值，該值指示是否啟用此組件。
	Filter	獲取或設置篩選字符串，用于確定在目錄中監視哪些文件。
	IncludeSubdirectories	獲取或設置一個值，該值指示是否監視指定路徑中的子目錄。
	InternalBufferSize	獲取或設置內部緩沖區的大小。
	NotifyFilter	獲取或設置要監視的更改類型。
	Path	獲取或設置要監視的目錄的路徑。
	Site	已重寫。獲取或設置 FileSystemWatcher 的 ISite。
	SynchronizingObject	獲取或設置一個對象，該對象用于封送因目錄更改而發出的事件處理程序調用。

受保護的屬性

?	名稱	說明
	CanRaiseEvents?	獲取一個指示組件是否可以引發事件的值。（從 Component 繼承。）
	DesignMode?	獲取一個值，用以指示 Component 當前是否處于設計模式。（從 Component 繼承。）
	Events?	獲取附加到此 Component 的事件處理程序的列表。（從 Component 繼承。）

公共方法

?	名稱	說明
	BeginInit	開始初始化在窗體上使用或由另一個組件使用的 FileSystemWatcher。初始化發生在運行時。
	CreateObjRef?	創建一個對象，該對象包含生成用于與遠程對象進行通信的代理所需的全部相關信息。 （從 MarshalByRefObject 繼承。）
	Dispose	已重載。 釋放由 FileSystemWatcher 占用的資源。
	EndInit	結束在窗體上使用或由另一個組件使用的 FileSystemWatcher 的初始化。初始化發生在運行時。
	Equals?	已重載。 確定兩個 Object 實例是否相等。 （從 Object 繼承。）
	GetHashCode?	用作特定類型的哈希函數。GetHashCode 適合在哈希算法和數據結構（如哈希表）中使用。 （從 Object 繼承。）
	GetLifetimeService?	檢索控制此實例的生存期策略的當前生存期服務對象。 （從 MarshalByRefObject 繼承。）
	GetType?	獲取當前實例的 Type。 （從 Object 繼承。）
	InitializeLifetimeService?	獲取控制此實例的生存期策略的生存期服務對象。 （從 MarshalByRefObject 繼承。）
	ReferenceEquals?	確定指定的 Object 實例是否是相同的實例。 （從 Object 繼承。）
	ToString?	返回包含 Component 的名稱的 String（如果有）。不應重寫此方法。 （從 Component 繼承。）
	WaitForChanged	已重載。 返回結構的同步方法，該結構包含有關已發生的更改的特定信息。

受保護的方法

?	名稱	說明
	Dispose	已重載。 已重寫。 釋放由 FileSystemWatcher 占用的資源。
	Finalize?	在通過垃圾回收將 Component 回收之前，釋放非托管資源并執行其他清理操作。 （從 Component 繼承。）
	GetService?	返回一個對象，該對象表示由 Component 或它的 Container 提供的服務。 （從 Component 繼承。）
	MemberwiseClone?	已重載。 （從 MarshalByRefObject 繼承。）
	OnChanged	引發 Changed 事件。
	OnCreated	引發 Created 事件。
	OnDeleted	引發 Deleted 事件。
	OnError	引發 Error 事件。
	OnRenamed	引發 Renamed 事件。

公共事件

?	名稱	說明
	Changed	當更改指定 Path 中的文件和目錄時發生。
	Created	當在指定 Path 中創建文件和目錄時發生。
	Deleted	刪除指定 Path 中的文件或目錄時發生。
	Disposed?	添加事件處理程序以偵聽組件上的 Disposed 事件。（從 Component 繼承。）
	Error	當內部緩沖區溢出時發生。
	Renamed	重命名指定 Path 中的文件或目錄時發生。

下面的示例創建一個 FileSystemWatcher，以便在運行時監視指定的目錄。組件設置為監視 LastWrite 和 LastAccess 時間方面的更改，以及目錄中文本文件的創建、刪除或重命名。如果更改、創建或刪除文件，文件路徑將被輸出到控制臺。在文件重命名后，舊路徑和新路徑都輸出到控制臺。

在此示例中使用 System.Diagnostics 和 System.IO 命名空間。

C# 事例：

?1public?class?Watcher
?2{
?3
?4????public?static?void?Main()
?5????{
?6????Run();
?7
?8????}
?9
10????[PermissionSet(SecurityAction.Demand,?Name="FullTrust")]
11????public?static?void?Run()
12????{
13????????string[]?args?=?System.Environment.GetCommandLineArgs();
14?
15????????//?If?a?directory?is?not?specified,?exit?program.
16????????if(args.Length?!=?2)
17????????{
18????????????//?Display?the?proper?way?to?call?the?program.
19????????????Console.WriteLine("Usage:?Watcher.exe?(directory)");
20????????????return;
21????????}
22
23????????//?Create?a?new?FileSystemWatcher?and?set?its?properties.
24????????FileSystemWatcher?watcher?=?new?FileSystemWatcher();
25????????watcher.Path?=?args[1];
26????????/**//*?Watch?for?changes?in?LastAccess?and?LastWrite?times,?and?
27???????????the?renaming?of?files?or?directories.?*/
28????????watcher.NotifyFilter?=?NotifyFilters.LastAccess?|?NotifyFilters.LastWrite?
29???????????|?NotifyFilters.FileName?|?NotifyFilters.DirectoryName;
30????????//?Only?watch?text?files.
31????????watcher.Filter?=?"*.txt";
32
33????????//?Add?event?handlers.
34????????watcher.Changed?+=?new?FileSystemEventHandler(OnChanged);
35????????watcher.Created?+=?new?FileSystemEventHandler(OnChanged);
36????????watcher.Deleted?+=?new?FileSystemEventHandler(OnChanged);
37????????watcher.Renamed?+=?new?RenamedEventHandler(OnRenamed);
38
39????????//?Begin?watching.
40????????watcher.EnableRaisingEvents?=?true;
41
42????????//?Wait?for?the?user?to?quit?the?program.
43????????Console.WriteLine("Press?\'q\'?to?quit?the?sample.");
44????????while(Console.Read()!='q');
45????}
46
47????//?Define?the?event?handlers.
48????private?static?void?OnChanged(object?source,?FileSystemEventArgs?e)
49????{
50????????//?Specify?what?is?done?when?a?file?is?changed,?created,?or?deleted.
51???????Console.WriteLine("File:?"?+??e.FullPath?+?"?"?+?e.ChangeType);
52????}
53
54????private?static?void?OnRenamed(object?source,?RenamedEventArgs?e)
55????{
56????????//?Specify?what?is?done?when?a?file?is?renamed.
57????????Console.WriteLine("File:?{0}?renamed?to?{1}",?e.OldFullPath,?e.FullPath);
58????}
59}