FileSystemWatcher.Error Ereignis
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Tritt auf, wenn die Instanz der FileSystemWatcher Überwachung von Änderungen nicht fortgesetzt werden 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 ausgelöst, wenn etwas verhindert, dass das FileSystemWatcher Objekt Änderungen überwacht. Wenn das Objekt beispielsweise Änderungen in einem Remoteverzeichnis überwacht und die Verbindung zu diesem Verzeichnis verloren geht, 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 es in kurzer Zeit viele Änderungen gibt, kann der Puffer überlaufen. Die Komponente verliert dadurch die Fähigkeit, Änderungen im Verzeichnis nachzuverfolgen, und wird nur allgemeine Benachrichtigungen bereitstellen. Das Erhöhen der Größe des Puffers ist teuer, da er aus nicht ausgelagerten Arbeitsspeicher stammt, der nicht auf den Datenträger getauscht werden kann, sodass der Puffer so klein wie möglich bleibt. Um einen Pufferüberlauf zu vermeiden, verwenden Sie die NotifyFilterEigenschaften , und Filter verwenden Sie die EigenschaftenIncludeSubdirectories, um unerwünschte Änderungsbenachrichtigungen auszufiltern.
Note
Allgemeine Dateisystemvorgänge lösen möglicherweise mehr als ein Ereignis aus. Wenn beispielsweise eine Datei von einem Verzeichnis in ein anderes verschoben wird, können mehrere OnChanged- und einige OnCreated- sowie OnDeleted-Ereignisse ausgelöst werden. Das Verschieben einer Datei ist ein komplexer Vorgang, der aus mehreren einfachen Vorgängen besteht, wodurch mehrere Ereignisse ausgelöst werden. Ebenso können Anwendungen wie z. B. Antivirensoftware zusätzliche Dateisystemereignisse auslösen, die von FileSystemWatcher erkannt werden.
