Teilen über


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.

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 

Ereignistyp

Attribute

Hinweise

Dieses Ereignis wird immer dann ausgelöst, wenn das Objekt daran FileSystemWatcher hindert, Änderungen zu überwachen. Wenn das -Objekt beispielsweise Änderungen in einem Remoteverzeichnis überwacht und die Verbindung mit diesem Verzeichnis unterbrochen wird, wird das Error -Ereignis ausgelöst.

Das System benachrichtigt Sie über Dateiänderungen und speichert diese Änderungen in einem Puffer, den die Komponente erstellt und an die APIs übergibt. Wenn in kurzer Zeit viele Änderungen vorgenommen werden, kann der Puffer überlaufen. Dies führt dazu, dass die Komponente den Überblick über Änderungen im Verzeichnis verliert und nur eine allgemeine Benachrichtigung bereitstellt. Das Erhöhen der Größe des Puffers ist teuer, da er aus nicht ausgelagertem Speicher stammt, der nicht auf den Datenträger ausgetauscht werden kann. Halten Sie den Puffer daher so klein wie möglich. Um einen Pufferüberlauf zu vermeiden, verwenden Sie die NotifyFilterEigenschaften , Filterund IncludeSubdirectories , um unerwünschte Änderungsbenachrichtigungen herauszufiltern.

Hinweis

Allgemeine Dateisystemvorgänge können mehrere Ereignisse auslösen. Wenn beispielsweise eine Datei aus einem Verzeichnis in ein anderes verschoben wird, können mehrere OnChanged und einige OnCreated - und OnDeleted -Ereignisse ausgelöst werden. Das Verschieben einer Datei ist ein komplexer Vorgang, der aus mehreren einfachen Vorgängen besteht und daher mehrere Ereignisse auslöst. Ebenso können einige Anwendungen (z. B. Antivirensoftware) zusätzliche Dateisystemereignisse verursachen, die von FileSystemWatchererkannt werden.

Gilt für:

Weitere Informationen