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和OnDeleted一些OnCreated事件。 移动文件是一项复杂的操作,由多个简单操作组成,因此引发多个事件。 同样,某些应用程序 (例如,防病毒软件) 可能会导致 检测到 FileSystemWatcher的其他文件系统事件。