FileSystemWatcher.Error イベント

定義

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
属性

注釈

このイベントは、何かがオブジェクトによる変更の FileSystemWatcher 監視を妨げるたびに発生します。 たとえば、 オブジェクトがリモート ディレクトリの変更を監視し、そのディレクトリへの接続が失われた場合、 Error イベントが発生します。

システムはファイルの変更を通知し、コンポーネントが作成して API に渡すバッファーにそれらの変更を格納します。 短時間に多くの変更がある場合は、バッファーがオーバーフローする可能性があります。 これにより、コンポーネントはディレクトリ内の変更を追跡しなきれ、通知のみを提供します。 バッファーのサイズを増やすと、ディスクにスワップアウトできない非ページ メモリから送信されるので、バッファーのサイズを小さくする方がコストがかかります。 バッファー オーバーフローを回避するには、および プロパティを使用して NotifyFilter Filter 、不要な変更 IncludeSubdirectories 通知をフィルターで除去します。

注意

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

適用対象

こちらもご覧ください