FileSystemWatcher.Error FileSystemWatcher.Error FileSystemWatcher.Error FileSystemWatcher.Error Event

Definizione

Viene generato quando l'istanza dell'oggetto FileSystemWatcher non è in grado di continuare il monitoraggio delle modifiche o quando si verifica un overflow del buffer interno.Occurs when the instance of FileSystemWatcher is unable to continue monitoring changes or when the internal buffer overflows.

public:
 event System::IO::ErrorEventHandler ^ Error;
[System.ComponentModel.Browsable(false)]
public event System.IO.ErrorEventHandler Error;
member this.Error : System.IO.ErrorEventHandler 
Public Custom Event Error As ErrorEventHandler 
Attributi

Commenti

Questo evento viene generato ogni volta che un FileSystemWatcher elemento impedisce a un oggetto di monitorare le modifiche.This event is raised whenever something prevents the FileSystemWatcher object from monitoring changes. Se, ad esempio, l'oggetto monitora le modifiche in una directory remota e la connessione a tale directory viene persa, Error viene generato l'evento.For example, if the object is monitoring changes in a remote directory and the connection to that directory is lost, the Error event is raised.

Il sistema notifica le modifiche ai file e archivia tali modifiche in un buffer che il componente crea e passa alle API.The system notifies you of file changes, and it stores those changes in a buffer that the component creates and passes to the APIs. Se sono presenti molte modifiche in un breve periodo di tempo, è possibile che si verifichi un overflow del buffer.If there are many changes in a short time, the buffer can overflow. In questo modo, il componente perderà il rilevamento delle modifiche nella directory e fornirà solo una notifica di copertura.This causes the component to lose track of changes in the directory, and it will only provide blanket notification. L'aumento delle dimensioni del buffer è costoso, perché deriva dalla memoria non di paging che non può essere scambiata su disco, quindi tenere il buffer il più piccolo possibile.Increasing the size of the buffer is expensive, because it comes from non paged memory that cannot be swapped out to disk, so keep the buffer as small as possible. Per evitare un overflow del buffer, utilizzare NotifyFilterle Filterproprietà, IncludeSubdirectories e per filtrare le notifiche di modifica indesiderate.To avoid a buffer overflow, use the NotifyFilter, Filter, and IncludeSubdirectories properties to filter out unwanted change notifications.

Nota

Le operazioni comuni di file system possono generare più di un evento.Common file system operations might raise more than one event. Ad esempio, quando un file viene spostato da una directory a un'altra, OnChanged OnCreated è possibile che OnDeleted vengano generati alcuni eventi e.For example, when a file is moved from one directory to another, several OnChanged and some OnCreated and OnDeleted events might be raised. Lo stato di un file è un'operazione complessa costituita da più semplici operazioni, che pertanto generano più eventi.Moving a file is a complex operation that consists of multiple simple operations, therefore raising multiple events. Analogamente, alcune applicazioni (ad esempio, il software antivirus) potrebbero causare eventi di file system aggiuntivi rilevati da FileSystemWatcher.Likewise, some applications (for example, antivirus software) might cause additional file system events that are detected by FileSystemWatcher.

Si applica a

Vedi anche