FileSystemWatcher.Error 事件

  • 参考

定义

命名空间:
System.IO
程序集:
System.IO.FileSystem.Watcher.dll
程序集:
System.dll
程序集:
netstandard.dll
Source:
FileSystemWatcher.cs
Source:
FileSystemWatcher.cs
Source:
FileSystemWatcher.cs

当 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

事件类型

ErrorEventHandler
属性
BrowsableAttribute

注解

每当对象无法监视更改时， FileSystemWatcher 将引发此事件。 例如，如果 对象正在监视远程目录中的更改，并且与该目录的连接丢失， Error 则会引发 事件。

系统会通知你文件更改，并将这些更改存储在组件创建并传递给 API 的缓冲区中。 如果在短时间内发生了许多更改，缓冲区可能会溢出。 这会导致组件失去对目录中的更改的跟踪，并且它只会提供全面通知。 增加缓冲区大小的成本很高，因为它来自无法交换到磁盘的非分页内存，因此请尽可能减小缓冲区。 若要避免缓冲区溢出，请使用 NotifyFilter、 Filter和 IncludeSubdirectories 属性筛选掉不需要的更改通知。

注意

常见的文件系统操作可能会引发多个事件。 例如，当文件从一个目录移动到另一个目录时，可能会引发多个 OnChanged 和一些 OnCreated 和 OnDeleted 事件。 移动文件是一项复杂的操作，由多个简单操作组成，因此引发多个事件。 同样，某些应用程序 (例如，防病毒软件) 可能会导致 检测到 FileSystemWatcher的其他文件系统事件。

适用于

另请参阅