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的其他文件系统事件。
| 产品 | 版本 |
|---|---|
| .NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
| .NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 2.0, 2.1 |
