FileSystemWatcher.Error Ereignis

Definition

Tritt ein, wenn die Instanz von FileSystemWatcher das Überwachen von Änderungen nicht fortzusetzen kann oder wenn der interne Puffer überläuft.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;
[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 

Ereignistyp

ErrorEventHandler
Attribute

Hinweise

Dieses Ereignis wird immer dann ausgelöst, wenn das FileSystemWatcher Objektänderungen an der Überwachung von Änderungen verhindert.This event is raised whenever something prevents the FileSystemWatcher object from monitoring changes. Wenn das Objekt z. b. Änderungen in einem Remote Verzeichnis überwacht und die Verbindung mit diesem Verzeichnis unterbrochen wird, wird das- Error Ereignis ausgelöst.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.

Das System benachrichtigt Sie über Dateiänderungen und speichert diese Änderungen in einem Puffer, den die Komponente erstellt und an die APIs übergibt.The system notifies you of file changes, and it stores those changes in a buffer that the component creates and passes to the APIs. Wenn in kurzer Zeit viele Änderungen vorgenommen werden, kann der Puffer einen Überlauf verursachen.If there are many changes in a short time, the buffer can overflow. Dies bewirkt, dass die Komponente Änderungen im Verzeichnis nachverfolgt und nur eine Benachrichtigung über eine Benachrichtigung erhält.This causes the component to lose track of changes in the directory, and it will only provide blanket notification. Die Vergrößerung des Puffers ist aufwendig, da er aus nicht auslagererem Speicher stammt, der nicht auf den Datenträger ausgelagert werden kann, sodass der Puffer so klein wie möglich bleibt.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. Um einen Pufferüberlauf zu vermeiden, verwenden NotifyFilter Filter Sie die Eigenschaften, und, IncludeSubdirectories um unerwünschte Änderungs Benachrichtigungen herauszufiltern.To avoid a buffer overflow, use the NotifyFilter, Filter, and IncludeSubdirectories properties to filter out unwanted change notifications.

Hinweis

Allgemeine Dateisystem Vorgänge können mehr als ein Ereignis hervorrufen.Common file system operations might raise more than one event. Wenn eine Datei z. b. von einem Verzeichnis in ein anderes verschoben wird, OnChanged OnCreated werden möglicherweise mehrere und einige-und- OnDeleted Ereignisse ausgelöst.For example, when a file is moved from one directory to another, several OnChanged and some OnCreated and OnDeleted events might be raised. Das Verschieben einer Datei ist ein komplexer Vorgang, der aus mehreren einfachen Vorgängen besteht, wodurch mehrere Ereignisse erhöht werden.Moving a file is a complex operation that consists of multiple simple operations, therefore raising multiple events. Ebenso können einige Anwendungen (z. b. Antivirussoftware) zusätzliche Dateisystem Ereignisse auslösen, die von erkannt werden FileSystemWatcher .Likewise, some applications (for example, antivirus software) might cause additional file system events that are detected by FileSystemWatcher.

Gilt für:

Weitere Informationen