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 的緩衝區中。 如果短時間內有許多變更,緩衝區可能會溢位。 這會導致元件遺失目錄中的變更追蹤,而且只會提供一個通知。 增加緩衝區的大小很昂貴,因為它來自無法交換至磁片的非分頁式記憶體,因此盡可能讓緩衝區保持較小。 若要避免緩衝區溢位,請使用 NotifyFilterFilterIncludeSubdirectories 屬性來篩選掉不必要的變更通知。

注意

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

適用於

另請參閱