語言

FileSystemWatcher.Error 事件

定義

當 的 FileSystemWatcher 實例無法繼續監控變更,或內部緩衝區溢位時會發生。

public:
 event System::IO::ErrorEventHandler ^ Error;
public event System.IO.ErrorEventHandler? Error;
public event System.IO.ErrorEventHandler Error;
[System.ComponentModel.Browsable(false)]
public event System.IO.ErrorEventHandler Error;
member this.Error : System.IO.ErrorEventHandler 
[<System.ComponentModel.Browsable(false)>]
member this.Error : System.IO.ErrorEventHandler 
Public Custom Event Error As ErrorEventHandler 

事件類型

屬性

備註

每當有東西阻止物件 FileSystemWatcher 監控變化時,這個事件就會被觸發。 例如,如果物件正在監控遠端目錄的變更,且與該目錄的連線中斷,事件 Error 就會被觸發。

系統會通知你檔案變更,並將這些變更儲存在元件建立並傳給 API 的緩衝區中。 如果短時間內有許多變更,緩衝區可能會溢位。 這會導致元件無法追蹤目錄中的變更,且只會提供全面性的通知。 增加緩衝區大小成本較高,因為它來自無法切換到磁碟的非分頁記憶體,因此應盡量保持緩衝區大小。 為避免緩衝區溢位,請使用 NotifyFilter、 Filter和 IncludeSubdirectories 屬性來過濾不想要的變更通知。

Note

常見的文件系統作業可能會引發一個以上的事件。 例如,當檔案從某個目錄移至另一個目錄時,可能會引發數 OnChanged 個和部分 OnCreated 和 OnDeleted 事件。 移動檔案是包含多個簡單作業的複雜作業,因此會引發多個事件。 同樣地,某些應用程式(例如防病毒軟體)可能會造成 所 FileSystemWatcher偵測到的其他文件系統事件。

適用於

另請參閱