FileSystemWatcher.Error イベント

[アーティクル]
03/28/2008

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

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.Error イベント

イベント データ

解説

必要条件

参照

その他のリソース

イベントデータ