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 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;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 Type d'événement
- Attributs
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.
