FileSystemWatcher.Error イベント
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
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 イベントの種類
- 属性
注釈
このイベントは、 FileSystemWatcher オブジェクトが変更を監視できなくなるたびに発生します。 たとえば、オブジェクトがリモート ディレクトリの変更を監視していて、そのディレクトリへの接続が失われた場合、 Error イベントが発生します。
システムはファイルの変更を通知し、コンポーネントが作成して API に渡すバッファーにそれらの変更を格納します。 短時間で多くの変更がある場合、バッファーがオーバーフローする可能性があります。 これにより、コンポーネントはディレクトリ内の変更を追跡しなくなります。また、一括通知のみが提供されます。 バッファーのサイズを大きくすると、ディスクにスワップアウトできない非ページング メモリが原因であるため、バッファーのサイズをできるだけ小さくしておく必要があります。 バッファー オーバーフローを回避するには、 NotifyFilter、 Filter、および IncludeSubdirectories プロパティを使用して、不要な変更通知を除外します。
Note
一般的なファイル システム操作では、複数のイベントが発生する可能性があります。 たとえば、ファイルが 1 つのディレクトリから別のディレクトリに移動されると、いくつかの OnChanged と一部の OnCreated および OnDeleted イベントが発生する可能性があります。 ファイルの移動は、複数の単純な操作で構成される複雑な操作であるため、複数のイベントが発生します。 同様に、一部のアプリケーション (ウイルス対策ソフトウェアなど) では、 FileSystemWatcherによって検出される追加のファイル システム イベントが発生する可能性があります。
