FileSystemWatcher.Error Evento

Definizione

Spazio dei nomi:

System.IO

Assembly:

System.IO.FileSystem.Watcher.dll

Source:

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 FileSystemWatcher di 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 ai file e archivia tali modifiche in un buffer creato e passa alle API. Se sono presenti molte modifiche in breve tempo, il buffer può sovraflow. In questo modo il componente perde la traccia delle modifiche nella directory e fornisce solo una notifica coperta. L'aumento delle dimensioni del buffer è costoso, perché proviene da memoria non paginata 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ù eventi. Ad esempio, quando un file viene spostato da una directory a un'altra, alcuni OnChanged e OnDeleted alcuni OnCreated eventi potrebbero essere generati. Lo spostamento di un file è un'operazione complessa costituita da più operazioni semplici, generando quindi più eventi. Analogamente, alcune applicazioni (ad esempio, software antivirus) potrebbero causare eventi aggiuntivi del file system rilevati da FileSystemWatcher.

Vedi anche

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