FileSystemWatcher.Error イベント

  • [アーティクル]

内部バッファがオーバーフローしたときに発生します。

Public Event Error As ErrorEventHandler
[C#]
public event ErrorEventHandler Error;
[C++]
public: __event ErrorEventHandler* Error;

[JScript] JScript では、このクラスで定義されているイベントを処理できます。ただし、独自に定義することはできません。

イベント データ

イベント ハンドラが、このイベントに関連するデータを含む、ErrorEventArgs 型の引数を受け取りました。

解説

システムは、ファイルの変更を通知し、コンポーネントが作成するバッファにその変更を格納して、アプリケーション プログラミング インターフェイス (API) に渡します。短時間に多くの変更が発生すると、バッファがオーバーフローすることがあります。これにより、コンポーネントはディレクトリの変更は追跡せず、ブランケットの通知だけを行います。バッファのサイズを大きくすると、そのメモリはディスクにスワップ アウトできない非ページ メモリから割り当てられるため、負荷は大きくなります。そのため、バッファはできるだけ小さくしてください。バッファのオーバーフローを防ぐには、 NotifyFilter 、 Filter 、 IncludeSubdirectories の各プロパティを使用して、不必要な変更通知をフィルタで排除します。

メモ   一般的なファイル システム操作で、複数のイベントが発生することがあります。たとえば、あるディレクトリから別のディレクトリにファイルを移動するとき、複数の OnChanged 、 OnCreated 、 OnDeleted の各イベントが発生することがあります。ファイルの移動は、複数の単純な操作から構成される複雑な操作です。そのため、複数のイベントが発生します。同様に、一部のアプリケーション (アンチウイルス ソフトウェアなど) では追加のファイル システム イベントが発生し、 FileSystemWatcher で検出されることがあります。

必要条件

プラットフォーム: Windows NT Server 4.0, Windows NT Workstation 4.0, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

参照

FileSystemWatcher クラス | FileSystemWatcher メンバ | System.IO 名前空間 | NotifyFilter | ErrorEventArgs | ErrorEventHandler | Filter | IncludeSubdirectories | OnError