FileSystemWatcher.Error-Ereignis

Artikel
08/20/2007

Tritt ein, wenn der interne Puffer überläuft.

Namespace: System.IO
Assembly: System (in system.dll)

Syntax

'Declaration
Public Event Error As ErrorEventHandler
'Usage
Dim instance As FileSystemWatcher
Dim handler As ErrorEventHandler

AddHandler instance.Error, handler

public event ErrorEventHandler Error

public:
event ErrorEventHandler^ Error {
    void add (ErrorEventHandler^ value);
    void remove (ErrorEventHandler^ value);
}

/** @event */
public void add_Error (ErrorEventHandler value)

/** @event */
public void remove_Error (ErrorEventHandler value)

JScript unterstützt die Verwendung von Ereignissen, aber nicht die Deklaration von neuen Ereignissen.

Hinweise

Das System benachrichtigt Sie über Dateiänderungen und speichert diese Änderungen in einem Puffer, der durch die Komponente erstellt und an die APIs übergeben wird. Wenn in kurzen Abständen Änderungen vorgenommen werden, kann es zu einem Überlauf des Puffers kommen. Dies führt dazu, dass die Komponente die Änderungen im Verzeichnis nicht mehr verfolgen kann. Die Komponente kann dann nur allgemeine Benachrichtigungen bereitstellen. Das Erhöhen der Puffergröße ist aufwendiger, da Systemspeicher genutzt wird, der nicht auf die Festplatte ausgelagert werden kann. Der Puffer sollte deshalb so klein wie möglich gehalten werden. Um einen Überlauf des Puffers zu vermeiden, verwenden Sie die NotifyFilter-Eigenschaft, die Filter-Eigenschaft und die IncludeSubdirectories-Eigenschaft, um nicht erwünschte Änderungsbenachrichtigungen herauszufiltern.

Hinweis

Häufige Vorgänge in Dateisystemen können mehrere Ereignisse auslösen. Wenn eine Datei z. B. von einem Verzeichnis in ein anderes verschoben wird, werden möglicherweise mehrere OnChanged-Ereignisse und einige OnCreated-Ereignisse sowie OnDeleted-Ereignisse ausgelöst. 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 Ereignisse in Dateisystemen auslösen, die von FileSystemWatcher erkannt werden.

Plattformen

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

FileSystemWatcher-Klasse
FileSystemWatcher-Member
System.IO-Namespace
FileSystemWatcher.NotifyFilter-Eigenschaft
ErrorEventArgs-Klasse
ErrorEventHandler-Delegat
FileSystemWatcher.Filter-Eigenschaft
FileSystemWatcher.IncludeSubdirectories-Eigenschaft
OnError

Share via