君子性非異也，善假于物也。

偵聽文件系統(tǒng)更改通知，并在目錄或目錄中的文件發(fā)生更改時引發(fā)事件。

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

繼承層次結(jié)構(gòu)

C# 用法：

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

使用 FileSystemWatcher 監(jiān)視指定目錄中的更改。可監(jiān)視指定目錄中的文件或子目錄的更改。可以創(chuàng)建一個組件來監(jiān)視本地計算機、網(wǎng)絡(luò)驅(qū)動器或遠程計算機上的文件。

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

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

可監(jiān)視文件或目錄的重命名、刪除或創(chuàng)建。例如，若要監(jiān)視文本文件的重命名，請將 Filter 屬性設(shè)置為“*.txt”，并使用為其參數(shù)指定的 Renamed 來調(diào)用 WaitForChanged 方法。

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

有關(guān) FileSystemWatcher 的實例的初始屬性值列表，請參見 FileSystemWatcher 構(gòu)造函數(shù)。

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

• 不忽略隱藏文件。

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

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

復制和移動文件夾

事件和緩沖區(qū)大小

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

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

• 使用 InternalBufferSize 屬性增加緩沖區(qū)大小可以防止丟失文件系統(tǒng)更改事件。

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

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

FileSystemWatcher 成員

公共構(gòu)造函數(shù)

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

公共屬性

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

受保護的屬性

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

公共方法

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

受保護的方法

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

公共事件

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

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

在此示例中使用 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}