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 que quelque chose 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 informe des modifications apportées aux fichiers 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 dans un court laps de temps, la mémoire tampon peut déborder. Cela entraîne la perte du suivi des modifications apportées au répertoire par le composant 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 sur 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 événements et certains OnCreated 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)