FileSystemWatcher.Error 事件

当内部缓冲区溢出时发生。

**命名空间:**System.IO
**程序集:**System（在 system.dll 中）

语法

声明
Public Event Error As ErrorEventHandler
用法
Dim instance As FileSystemWatcher
Dim handler As ErrorEventHandler

AddHandler instance.Error, handler

public event ErrorEventHandler Error

public:
event ErrorEventHandler^ Error {
    void add (ErrorEventHandler^ value);
    void remove (ErrorEventHandler^ value);
}

/** @event */
public void add_Error (ErrorEventHandler value)

/** @event */
public void remove_Error (ErrorEventHandler value)

JScript 支持使用事件，但不支持进行新的声明。

备注

系统通知文件发生更改，并将这些更改存储在组件创建并传递给 API 的缓冲区中。如果短时间内有很多更改，则缓冲区可能会溢出。这将导致组件失去对目录更改的跟踪，并且它将只提供一般性通知。增加缓冲区大小的开销较大，因为它来自无法换出到磁盘的非分页内存，所以将缓冲区保持得越小越好。若要避免缓冲区溢出，请使用 NotifyFilter、Filter 和 IncludeSubdirectories 属性筛选掉不想要的更改通知。

提示

公共文件系统操作可能会引发多个事件。例如，将文件从一个目录移到另一个目录时，可能会引发若干 OnChanged 以及一些 OnCreated 和 OnDeleted 事件。移动文件是一个包含多个简单操作的复杂操作，因此会引发多个事件。同样，有些应用程序（例如，防病毒软件）可能会导致可由 FileSystemWatcher 检测到的其他文件系统事件。

平台

Windows 98、Windows 2000 SP4、Windows Server 2003、Windows XP Media Center Edition、Windows XP Professional x64 Edition、Windows XP SP2、Windows XP Starter Edition

.NET Framework 并不是对每个平台的所有版本都提供支持。有关受支持版本的列表，请参见系统要求。

版本信息

.NET Framework

受以下版本支持：2.0、1.1、1.0

请参见

参考

FileSystemWatcher 类
FileSystemWatcher 成员
System.IO 命名空间
FileSystemWatcher.NotifyFilter 属性
ErrorEventArgs 类
ErrorEventHandler 委托
FileSystemWatcher.Filter 属性
FileSystemWatcher.IncludeSubdirectories 属性
OnError