FileSystemWatcher.Error Evento
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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;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 Tipo evento
- Attributi
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.
