FileSystemWatcher.Error イベント

定義

FileSystemWatcher のインスタンスが変更の監視を続けられない場合、または内部バッファー オーバーフローの場合に発生します。Occurs when the instance of FileSystemWatcher is unable to continue monitoring changes or when the internal buffer overflows.

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 します。This event is raised whenever something prevents the FileSystemWatcher object from monitoring changes. たとえば、オブジェクトがリモートディレクトリの変更を監視していて、そのディレクトリへの接続が失われた場合、 Error イベントが発生します。For example, if the object is monitoring changes in a remote directory and the connection to that directory is lost, the Error event is raised.

システムは、ファイルの変更を通知し、コンポーネントによって作成および Api に渡されるバッファーにそれらの変更を保存します。The system notifies you of file changes, and it stores those changes in a buffer that the component creates and passes to the APIs. 短時間で多くの変更が加えられた場合、バッファーがオーバーフローする可能性があります。If there are many changes in a short time, the buffer can overflow. これにより、コンポーネントはディレクトリの変更を追跡できなくなり、一括通知のみが提供されます。This causes the component to lose track of changes in the directory, and it will only provide blanket notification. バッファーのサイズを大きくすると、ディスクにスワップできないページングされていないメモリからのものであるため、サイズが大きくなります。バッファーはできるだけ小さくしてください。Increasing the size of the buffer is expensive, because it comes from non paged memory that cannot be swapped out to disk, so keep the buffer as small as possible. バッファーオーバーフローを回避するには、 NotifyFilter 、、およびの各プロパティを使用して、 Filter 不要な IncludeSubdirectories 変更通知を除外します。To avoid a buffer overflow, use the NotifyFilter, Filter, and IncludeSubdirectories properties to filter out unwanted change notifications.

注意

一般的なファイルシステム操作では、複数のイベントが発生する可能性があります。Common file system operations might raise more than one event. たとえば、あるディレクトリから別のディレクトリにファイルを移動すると、いくつかの OnChanged OnCreated OnDeleted イベントとイベントが発生する可能性があります。For example, when a file is moved from one directory to another, several OnChanged and some OnCreated and OnDeleted events might be raised. ファイルの移動は、複数の単純な操作で構成される複雑な操作であるため、複数のイベントが発生します。Moving a file is a complex operation that consists of multiple simple operations, therefore raising multiple events. 同様に、一部のアプリケーション (ウイルス対策ソフトウェアなど) によって、によって検出された追加のファイルシステムイベントが発生する可能性があり FileSystemWatcher ます。Likewise, some applications (for example, antivirus software) might cause additional file system events that are detected by FileSystemWatcher.

適用対象

こちらもご覧ください