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
