FileSystemWatcher用法詳解
FileSystemWatcher控件主要功能:
監控指定文件或目錄的文件的創建、刪除、改動、重命名等活動。可以動態地定義需要監控的文件類型及文件屬性改動的類型。
1.常用的幾個基本屬性:
(1) Path :設置要監視的目錄的路徑。
(2) IncludeSubdirectories :設置是否級聯監視指定路徑中的子目錄。
(3) Filter :設置篩選字符串,用於確定在目錄中監視哪些類型的文件。
(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 對象:
成員:Name: 獲取受影響的文件或目錄的名稱。 注意:如果是級聯監控子目錄的話,該值為從監控目錄的下個目錄到受影響的文件的路徑,而不只是受影響的文件名。
FullPath : 獲取受影響的文件或目錄的完全限定的路徑。
ChangeType :獲取受影響的文件或目錄的發生的事件類型。
子項:All -- 文件或文件夾的創建、刪除、更改或重命名。
Changed -- 文件或文件夾的更改。更改的類型包括大小、屬性、安全設置、最近寫入時間和最近訪問時間方面的更改。
Created -- 文件或文件夾的創建。
Deleted -- 文件或文件夾的刪除。
Renamed -- 文件或文件夾的重命名。
(6) RenamedEventArgs 對象:
成員:Name: 獲取受影響的文件或目錄的新名稱。
OldName : 獲取受影響的文件或目錄的舊名稱。
FullPath : 獲取受影響的文件或目錄的完全限定的路徑。
OldFullPath : 獲取受影響的文件或目錄的前一個完全限定的路徑。
ChangeType :獲取受影響的文件或目錄的發生的事件類型。
子項:All -- 文件或文件夾的創建、刪除、更改或重命名。
Changed -- 文件或文件夾的更改。更改的類型包括大小、屬性、安全設置、最近寫入時間和最近訪問時間方面的更改。
Created -- 文件或文件夾的創建。
Deleted -- 文件或文件夾的刪除。
Renamed -- 文件或文件夾的重命名。
1 private delegate void setLogTextDelegate(FileSystemEventArgs e); //聲明傳遞FileSystemEventArgs對象的委托,用於文件Created,Deleted和Changed變動時更新UI界面。 2 3 private delegate void renamedDelegate(RenamedEventArgs e); //聲明傳遞RenamedEventArgs對象的委托,用於文件Renamed時更新UI界面。 4 5 FileSystemWatcher fsw= new FileSystemWatcher(); 6 7 fsw.Path = “C:\\”; //設置監控的文件目錄 8 9 fsw.IncludeSubdirectories = true; //設置監控C盤目錄下的所有子目錄 10 11 fsw.Filter = "*.txt|*.doc|*.jpg"; //設置監控文件的類型 12 13 fsw.NotifyFilter = NotifyFilters.FileName | NotifyFilters.DirectoryName | NotifyFilters.Size; //設置文件的文件名、目錄名及文件的大小改動會觸發Changed事件 14 15 fsw.Created += new FileSystemEventHandler(this.fileSystemWatcher_EventHandle); //綁定事件觸發后處理數據的方法。 16 17 fsw.Deleted += new FileSystemEventHandler(this.fileSystemWatcher_EventHandle); 18 19 fsw.Changed += new FileSystemEventHandler(this.fileSystemWatcher_EventHandle); 20 21 fsw.Renamed += new RenamedEventHandler(this.fileSystemWatcher_Renamed); //重命名事件與增刪改傳遞的參數不一樣。 22 23 fsw.EnableRaisingEvents = true; //啟動監控 24 25 private void fileSystemWatcher_EventHandle(object sender, FileSystemEventArgs e) //文件增刪改時被調用的處理方法 26 { 27 if (this.listView1.InvokeRequired) //判斷是否跨線程 28 { 29 this.listView1.Invoke(new setLogTextDelegate(setLogText), new object[] { e }); //使用委托將方法封送到UI主線程處理 30 } 31 } 32 33 private void fileSystemWatcher_Renamed(object sender,RenamedEventArgs e) //文件重命名時被調用的處理方法 34 { 35 if (this.listView1.InvokeRequired) //判斷是否跨線程 36 { 37 this.listView1.Invoke(new renamedDelegate(setRenamedLogText), new object[] { e }); //使用委托將方法封送到UI主線程處理 38 } 39 } 40 41 private void setLogText(FileSystemEventArgs e) //更新UI界面 42 { 43 ListViewItem lvi = new ListViewItem(); 44 45 lvi.SubItems.Add(e.Name); //受影響的文件名 46 47 lvi.SubItems.Add(e.ChangeType.ToString()); //受影響文件的變動類型(可能為Created、Changed、Deleted) 48 49 lvi.SubItems.Add(e.FullPath); //受影響的文件完整路徑 50 51 this.listView1.Items.Add(lvi); 52 } 53 54 private void setRenamedLogText(RenamedEventArgs e) //更新UI界面 55 { 56 ListViewItem lvi = new ListViewItem(); 57 58 lvi.SubItems.Add(e.OldName); //受影響的文件的原名 59 60 lvi.SubItems.Add(e.ChangeType.ToString()); //受影響的文件的改動類型(Rename) 61 62 lvi.SubItems.Add(e.Name); //受影響的文件的新名 63 64 lvi.SubItems.Add(e.OldFullPath); //受影響的文件的原路徑 65 66 lvi.SubItems.Add(e.FullPath); //受影響的文件的完整路徑(其實和原路徑一樣) 67 68 this.fileEventLog_lvw.Items.Add(lvi); 69 70 }
重點:
1.、因為FileSystemWatcher類本身就是多線程的控件,也就是每實例化一個FileSystemWatcher自動就會創建一條線程。
2、我們需要利用委托進行跨線程更新UI界面,因為重命名事件傳遞的是RenameEventArgs對象,而創建、修改、刪除事件傳遞的是FileEventArgs對象,所以需要聲明兩個委托。
3、如果需要同時監控多個文件(如監控系統全盤),只需要創建FileSystemWatcher數組,每個文件用一個FileSystemWatcher進行監控。
實例效果:
現放上以上C#文件監控的源碼,希望對大家學習有幫助: