FileSystemWatcher.Error Gebeurtenis
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Treedt op wanneer het exemplaar van FileSystemWatcher niet kan doorgaan met het bewaken van wijzigingen of wanneer de interne buffer overloopt.
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 Gebeurtenistype
- Kenmerken
Opmerkingen
Deze gebeurtenis wordt gegenereerd wanneer iets voorkomt dat het FileSystemWatcher object wijzigingen controleert. Als het object bijvoorbeeld wijzigingen in een externe map bewaakt en de verbinding met die map is verbroken, wordt de Error gebeurtenis gegenereerd.
Het systeem brengt u op de hoogte van bestandswijzigingen en slaat deze wijzigingen op in een buffer die het onderdeel maakt en doorgeeft aan de API's. Als er in korte tijd veel wijzigingen zijn, kan de buffer overlopen. Dit zorgt ervoor dat het onderdeel wijzigingen in de map niet meer kan bijhouden en er wordt alleen een dekenmelding weergegeven. Het vergroten van de grootte van de buffer is duur, omdat deze afkomstig is van niet-gepaginad geheugen dat niet naar schijf kan worden gewisseld, dus zorg ervoor dat de buffer zo klein mogelijk blijft. Als u een bufferoverloop wilt voorkomen, gebruikt u de NotifyFiltereigenschappen en FilterIncludeSubdirectories eigenschappen om ongewenste wijzigingsmeldingen uit te filteren.
Note
Veelvoorkomende bestandssysteembewerkingen kunnen meerdere gebeurtenissen veroorzaken. Wanneer een bestand bijvoorbeeld van de ene map naar de andere wordt verplaatst, kunnen er meerdere OnChanged en enkele OnCreated gebeurtenissen OnDeleted worden gegenereerd. Het verplaatsen van een bestand is een complexe bewerking die bestaat uit meerdere eenvoudige bewerkingen, waardoor meerdere gebeurtenissen worden gegenereerd. Op dezelfde manier kunnen sommige toepassingen (bijvoorbeeld antivirussoftware) aanvullende bestandssysteem-gebeurtenissen veroorzaken die worden gedetecteerd door FileSystemWatcher.
