FileSystemWatcher.Error Zdarzenie
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Występuje, gdy wystąpienie programu FileSystemWatcher nie może kontynuować monitorowania zmian lub gdy wewnętrzny bufor przepełnia się.
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 Typ zdarzenia
- Atrybuty
Uwagi
To zdarzenie jest zgłaszane za każdym razem, gdy coś uniemożliwia FileSystemWatcher obiektowi monitorowanie zmian. Jeśli na przykład obiekt monitoruje zmiany w katalogu zdalnym, a połączenie z tym katalogiem zostanie utracone, Error zdarzenie zostanie zgłoszone.
System powiadamia o zmianach plików i przechowuje te zmiany w buforze tworzonym przez składnik i przekazującym je do interfejsów API. Jeśli w krótkim czasie istnieje wiele zmian, bufor może przepełnić się. Spowoduje to utratę monitorowania zmian w katalogu przez składnik, który będzie dostarczać tylko ogólnikowe powiadomienia. Zwiększenie rozmiaru buforu jest kosztowne, ponieważ pochodzi z niestronicowanej pamięci, której nie można zamienić na dysk, więc zachowaj bufor tak mały, jak to możliwe. Aby uniknąć przepełnienia buforu NotifyFilter, użyj właściwości , Filteri IncludeSubdirectories , aby odfiltrować niechciane powiadomienia o zmianie.
Note
Typowe operacje systemu plików mogą zgłaszać więcej niż jedno zdarzenie. Na przykład, gdy plik jest przenoszony z jednego katalogu do drugiego, może wystąpić kilka zdarzeń OnChanged, a także niektóre zdarzenia OnCreated i OnDeleted. Przenoszenie pliku jest złożoną operacją składającą się z wielu prostych operacji, co powoduje uruchomienie wielu zdarzeń. Podobnie, niektóre aplikacje (na przykład oprogramowanie antywirusowe) mogą powodować dodatkowe zdarzenia systemu plików wykrywane przez FileSystemWatcher.
