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 屬性來篩選掉不必要的變更通知。
注意
常見的文件系統作業可能會引發一個以上的事件。 例如，當檔案從一個目錄移至另一個目錄時，可能會引發數 OnChanged 個和一些 OnCreated 和 OnDeleted 事件。 移動檔案是包含多個簡單作業的複雜作業，因此引發多個事件。 同樣地，某些應用程式 (例如，防病毒軟體) 可能會導致 偵測到的其他文件系統事件 FileSystemWatcher。
