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 di non è in grado di FileSystemWatcher continuare a monitorare le modifiche o quando il buffer interno supera i flussi.
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 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 invia una notifica alle modifiche apportate ai file e archivia tali modifiche in un buffer creato e passato alle API. Se sono presenti molte modifiche in breve tempo, il buffer può andare in overflow. 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 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 escludere le notifiche di modifica indesiderate.
Note
Le operazioni comuni del file system possono generare più eventi. Ad esempio, quando un file viene spostato da una directory a un'altra, potrebbero essere generati diversi OnChanged e alcuni OnCreated e OnDeleted eventi. Lo spostamento di un file è un'operazione complessa costituita da più operazioni semplici, generando quindi più eventi. Analogamente, alcune applicazioni (ad esempio, il software antivirus) potrebbero causare eventi aggiuntivi del file system rilevati da FileSystemWatcher.
