FileSystemWatcher.Error Událost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Vyvolá se, když instance FileSystemWatcher není schopen pokračovat v monitorování změn nebo při přetečení vnitřní vyrovnávací paměti.
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 Event Type
- Atributy
Poznámky
Tato událost je vyvolána vždy, když něco brání objektu FileSystemWatcher v monitorování změn. Pokud například objekt monitoruje změny ve vzdáleném adresáři a připojení k ho adresáři je ztraceno, Error je vyvolána událost.
Systém vás upozorní na změny souborů a uloží je do vyrovnávací paměti, kterou komponenta vytvoří a předá rozhraním API. Pokud během krátké doby dojde k mnoha změnám, může vyrovnávací paměť přetéct. To způsobí, že komponenta ztratí přehled o změnách v adresáři a bude poskytovat pouze plošné oznámení. Zvětšení velikosti vyrovnávací paměti je nákladné, protože pochází z nestránkované paměti, kterou nelze prohodit na disk, takže udržujte vyrovnávací paměť co nejmenší. Abyste zabránili přetečení vyrovnávací paměti, vyfiltrujte oznámení o nechtěných změnách pomocí NotifyFilterFiltervlastností , a IncludeSubdirectories .
Poznámka
Běžné operace systému souborů můžou vyvolat více než jednu událost. Například při přesunutí souboru z jednoho adresáře do jiného může dojít k vyvolání několika OnChanged a některých OnCreated událostí a OnDeleted . Přesunutí souboru je složitá operace, která se skládá z několika jednoduchých operací, a proto vyvolává více událostí. Podobně některé aplikace (například antivirový software) můžou způsobovat další události systému souborů, které zjistí FileSystemWatcher.
