FileSystemWatcher.Error Událost

Definice

Vyvolá se v případě, že instance FileSystemWatcher nemůže pokračovat v monitorování nebo když dojde k přetečení vnitřní vyrovnávací paměti.Occurs when the instance of FileSystemWatcher is unable to continue monitoring changes or when the internal buffer overflows.

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 
Public Custom Event Error As ErrorEventHandler 
Atributy

Poznámky

Tato událost se vyvolá vždy, když něco brání objektu FileSystemWatcher v monitorování změn.This event is raised whenever something prevents the FileSystemWatcher object from monitoring changes. Pokud například objekt sleduje změny ve vzdáleném adresáři a dojde ke ztrátě připojení k tomuto adresáři, je vyvolána událost Error.For example, if the object is monitoring changes in a remote directory and the connection to that directory is lost, the Error event is raised.

Systém oznamuje změny souborů a ukládá tyto změny do vyrovnávací paměti, kterou komponenta vytvoří a předá rozhraní API.The system notifies you of file changes, and it stores those changes in a buffer that the component creates and passes to the APIs. Pokud je v krátké době mnoho změn, vyrovnávací paměť může přetečení.If there are many changes in a short time, the buffer can overflow. Tím dojde k tomu, že komponenta ztratí sledovat změny v adresáři a bude poskytovat pouze hromadné oznámení.This causes the component to lose track of changes in the directory, and it will only provide blanket notification. Zvýšení velikosti vyrovnávací paměti je nákladné, protože pochází z nestránkované paměti, kterou nelze odkládací diskovat, takže velikost vyrovnávací paměti Udržujte co nejmenší.Increasing the size of the buffer is expensive, because it comes from non paged memory that cannot be swapped out to disk, so keep the buffer as small as possible. Chcete-li se vyhnout přetečení vyrovnávací paměti, použijte vlastnosti NotifyFilter, Filtera IncludeSubdirectories k odfiltrování nežádoucích oznámení o změně.To avoid a buffer overflow, use the NotifyFilter, Filter, and IncludeSubdirectories properties to filter out unwanted change notifications.

Poznámka

Běžné operace systému souborů mohou vyvolat více než jednu událost.Common file system operations might raise more than one event. Například když je soubor přesunut z jednoho adresáře do jiného, může být vyvoláno několik OnChanged a některé OnCreated a OnDeleted události.For example, when a file is moved from one directory to another, several OnChanged and some OnCreated and OnDeleted events might be raised. 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í.Moving a file is a complex operation that consists of multiple simple operations, therefore raising multiple events. Podobně některé aplikace (například antivirový software) mohou způsobit další události systému souborů, které jsou zjišťovány FileSystemWatcher.Likewise, some applications (for example, antivirus software) might cause additional file system events that are detected by FileSystemWatcher.

Platí pro

Viz také