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

适用于

另请参阅