FileSystemWatcher.Error FileSystemWatcher.Error FileSystemWatcher.Error FileSystemWatcher.Error Event

定義

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;
[System.ComponentModel.Browsable(false)]
public event System.IO.ErrorEventHandler Error;
member this.Error : System.IO.ErrorEventHandler 
Public Custom Event Error As 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. バッファーオーバーフローを回避するには、 NotifyFilterFilter、および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.

適用対象

こちらもご覧ください