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í.
Nastane, když instance FileSystemWatcher nemůže pokračovat v monitorování změn nebo když se vnitřní vyrovnávací paměť přeteče.
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 se vyvolá vždy, když objektu brání FileSystemWatcher v monitorování změn. Pokud například objekt monitoruje změny ve vzdáleném adresáři a dojde ke ztrátě připojení k danému adresáři, Error vyvolá se událost.
Systém vás upozorní na změny souboru a uloží tyto změny do vyrovnávací paměti, kterou komponenta vytvoří a předá rozhraním API. Pokud v krátké době dojde k mnoha změnám, může vyrovnávací paměť přetékat. Tímto komponenta ztratí přehled o změnách v adresáři a poskytne pouze obecné oznámení. Zvětšení velikosti vyrovnávací paměti je nákladné, protože pochází z nestránkované paměti, která se nedá vyměnit na disk, takže ponechte vyrovnávací paměť co nejmenší. Chcete-li zabránit přetečení vyrovnávací paměti, použijte NotifyFilterFilterIncludeSubdirectories a vlastnosti k vyfiltrujte nežádoucí oznámení o změnách.
Note
Běžné operace systému souborů můžou vyvolat více než jednu událost. Například když se soubor přesune z jednoho adresáře do jiného, může dojít k vyvolání několika OnChanged událostí, některých OnCreated událostí a OnDeleted událostí. 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) mohou způsobit další události systému souborů, které mohou být detekovány FileSystemWatcher.
