FileSystemWatcher.Error Événement
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Se produit lorsque l’instance de n’est pas en mesure de FileSystemWatcher continuer à surveiller les modifications ou lorsque la mémoire tampon interne dépasse.
public:
event System::IO::ErrorEventHandler ^ Error;[System.ComponentModel.Browsable(false)]
public event System.IO.ErrorEventHandler Error;[<System.ComponentModel.Browsable(false)>]
member this.Error : System.IO.ErrorEventHandler Public Custom Event Error As ErrorEventHandler Type d'événement
- Attributs
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 apportées à 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 existe de nombreuses modifications dans un court délai, la mémoire tampon peut déborder. Cela entraîne la perte du suivi des modifications dans le répertoire et ne fournit qu’une notification globale. 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 permutée sur le disque, de sorte que la mémoire tampon reste aussi petite que possible. Pour éviter un dépassement de mémoire tampon, utilisez les propriétés et FilterIncludeSubdirectories les NotifyFilterpropriétés pour filtrer les notifications de modification indésirables.
Note
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 événements OnChanged et certains événements OnCreated et OnDeleted peuvent être généré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 entraîner des événements de système de fichiers supplémentaires détectés par FileSystemWatcher.