FileSystemWatcher.Error Zdarzenie

  • Odwołanie

Definicja

Przestrzeń nazw:
System.IO
Zestaw:
System.IO.FileSystem.Watcher.dll
Zestaw:
System.dll
Zestaw:
netstandard.dll
Źródło:
FileSystemWatcher.cs
Źródło:
FileSystemWatcher.cs
Źródło:
FileSystemWatcher.cs

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

ErrorEventHandler
Atrybuty
BrowsableAttribute

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 .

Dotyczy

Zobacz też