FileSystemWatcher.Error Событие

Определение

Происходит, когда экземпляру FileSystemWatcher не удается продолжить отслеживание изменений, или при переполнении внутреннего буфера.

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 

Тип события

Атрибуты

Комментарии

Это событие возникает всякий раз, когда что-то мешает объекту FileSystemWatcher отслеживать изменения. Например, если объект отслеживает изменения в удаленном каталоге и соединение с этим каталогом теряется, Error возникает событие .

Система уведомляет об изменениях файла и сохраняет эти изменения в буфере, который компонент создает и передает в API. Если за короткое время будет много изменений, буфер может быть переполнен. Это приводит к тому, что компонент потеряет отслеживание изменений в каталоге и будет предоставлять только общее уведомление. Увеличение размера буфера является дорогостоящим, так как он поступает из нестраничной памяти, которую невозможно переключить на диск, поэтому буфер должен быть как можно меньше. Чтобы избежать переполнения буфера, используйте NotifyFilterсвойства , Filterи IncludeSubdirectories для фильтрации нежелательных уведомлений об изменениях.

Примечание

Распространенные операции файловой системы могут вызывать несколько событий. Например, при перемещении файла из одного каталога в другой могут возникать несколько OnChanged и некоторые OnCreated события и OnDeleted . Перемещение файла — это сложная операция, которая состоит из нескольких простых операций, поэтому вызывает несколько событий. Аналогичным образом некоторые приложения (например, антивирусная программа) могут вызывать дополнительные события файловой системы, обнаруженные .FileSystemWatcher

Применяется к

См. также раздел