FileSystemWatcher.Error Événement

Définition

Espace de noms:

System.IO

Assembly:

System.IO.FileSystem.Watcher.dll

Source:

FileSystemWatcher.cs

Se produit quand l'instance de FileSystemWatcher ne peut pas continuer à surveiller des modifications ou quand il y a un dépassement de mémoire tampon interne.

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

public event System.IO.ErrorEventHandler? Error;

member this.Error : System.IO.ErrorEventHandler 

Public Custom Event Error As ErrorEventHandler 

Type d'événement

ErrorEventHandler

Remarques

Cet événement est déclenché chaque fois qu’un élément empêche l’objet FileSystemWatcher de surveiller les modifications. Par exemple, si l’objet surveille les modifications dans un répertoire distant et que la connexion à ce répertoire est perdue, l’événement Error est déclenché.

Le système vous avertit des modifications de fichier et stocke ces modifications dans une mémoire tampon que le composant crée et transmet aux API. S’il y a de nombreuses modifications en peu de temps, la mémoire tampon peut déborder. Le composant perd ainsi le suivi des modifications apportées au répertoire et ne fournit qu’une notification générale. L’augmentation de la taille de la mémoire tampon est coûteuse, car elle provient de la mémoire non paginée qui ne peut pas être échangée vers le disque. Par conséquent, gardez la mémoire tampon aussi petite que possible. Pour éviter un dépassement de mémoire tampon, utilisez les NotifyFilterpropriétés , Filteret IncludeSubdirectories pour filtrer les notifications de modification indésirables.

Notes

Les opérations courantes du système de fichiers peuvent déclencher plusieurs événements. Par exemple, lorsqu’un fichier est déplacé d’un répertoire à un autre, plusieurs OnChanged et certains OnCreated événements et OnDeleted peuvent être déclenchés. Le déplacement d’un fichier est une opération complexe qui se compose de plusieurs opérations simples, ce qui déclenche plusieurs événements. De même, certaines applications (par exemple, les logiciels antivirus) peuvent provoquer des événements de système de fichiers supplémentaires détectés par FileSystemWatcher.

Voir aussi

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