FileSystemWatcher.Error Zdarzenie

Definicja

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 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 się przepełnić. Powoduje to utratę śledzenia zmian w katalogu i będzie dostarczać tylko ogólne powiadomienie. 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, użyj NotifyFilterwłaściwości , Filteri IncludeSubdirectories , aby odfiltrować niepożądane 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 niektóre OnCreatedOnDeleted zdarzenia. Przeniesienie pliku jest złożoną operacją, która składa się z wielu prostych operacji, w związku z czym zgłasza 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ż