FileSystemWatcher.Error 事件
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
當 的 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偵測到的其他文件系統事件。