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 nie FileSystemWatcher może kontynuować monitorowania zmian lub gdy wewnętrzne przepełnienie buforu.
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 i 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ć. Powoduje to utratę śledzenia zmian w katalogu przez składnik i będzie dostarczać tylko powiadomienie ogólne. Zwiększenie rozmiaru buforu jest kosztowne, ponieważ pochodzi z pamięci niestronicowanej, 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.
Uwaga
Typowe operacje systemu plików mogą zgłaszać więcej niż jedno zdarzenie. Na przykład po przeniesieniu pliku z jednego katalogu do innego może zostać zgłoszonych kilka OnChanged i OnDeleted niektóre OnCreated zdarzenia. Przenoszenie pliku jest złożoną operacją składającą się z wielu prostych operacji, dlatego wywołując wiele zdarzeń. Podobnie niektóre aplikacje (na przykład oprogramowanie antywirusowe) mogą powodować dodatkowe zdarzenia systemu plików, które są wykrywane przez FileSystemWatcherprogram .
