FileSystemWatcher.Error Evento

Definizione

Spazio dei nomi:

System.IO

Assembly:

System.IO.FileSystem.Watcher.dll

Origine:

FileSystemWatcher.cs

Si verifica quando l'istanza dell'oggetto FileSystemWatcher non è in grado di continuare il monitoraggio delle modifiche o quando si verifica un overflow del buffer interno.

public:
 event System::IO::ErrorEventHandler ^ Error;

public event System.IO.ErrorEventHandler? Error;

member this.Error : System.IO.ErrorEventHandler 

Public Custom Event Error As ErrorEventHandler 

Tipo evento

ErrorEventHandler

Commenti

Questo evento viene generato ogni volta che un elemento impedisce all'oggetto di FileSystemWatcher monitorare le modifiche. Ad esempio, se l'oggetto monitora le modifiche in una directory remota e la connessione a tale directory viene persa, viene generato l'evento Error .

Il sistema notifica le modifiche apportate ai file e archivia tali modifiche in un buffer che il componente crea e passa alle API. Se sono presenti molte modifiche in un breve periodo di tempo, il buffer può eseguire l'overflow. In questo modo il componente perderà traccia delle modifiche nella directory e fornirà solo una notifica generale. L'aumento delle dimensioni del buffer è costoso perché proviene da memoria non di paging che non può essere scambiata su disco, quindi mantenere il buffer il più piccolo possibile. Per evitare un overflow del buffer, usare le NotifyFilterproprietà , Filtere IncludeSubdirectories per filtrare le notifiche di modifica indesiderate.

Nota

Le operazioni comuni del file system possono generare più di un evento. Ad esempio, quando un file viene spostato da una directory a un'altra, potrebbero essere generati diversi OnChanged e alcuni OnCreated eventi e OnDeleted . Lo spostamento di un file è un'operazione complessa costituita da più operazioni semplici, pertanto la generazione di più eventi. Analogamente, alcune applicazioni (ad esempio, il software antivirus) potrebbero causare eventi aggiuntivi del file system rilevati da FileSystemWatcher.

Vedi anche

• NotifyFilter
• ErrorEventArgs
• ErrorEventHandler
• Filter
• IncludeSubdirectories
• OnError(ErrorEventArgs)