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. Если в течение короткого времени происходит много изменений, буфер может переполниться. Это приводит к тому, что компонент утрачивает возможность следить за изменениями в каталоге и будет предоставлять только общие уведомления. Увеличение размера буфера является дорогостоящим, так как оно поступает из нестраничной памяти, которая не может быть переключен на диск, поэтому сохраните буфер как можно меньше. Чтобы избежать переполнения буфера, используйте NotifyFilterFilterсвойства и IncludeSubdirectories свойства для фильтрации нежелательных уведомлений об изменениях.
Note
Распространенные операции файловой системы могут вызывать несколько событий. Например, при перемещении файла из одного каталога в другой может возникать несколько OnChanged и некоторые OnCreated и OnDeleted события. Перемещение файла — это сложная операция, состоящая из нескольких простых операций, поэтому вызывает несколько событий. Аналогичным образом, некоторые приложения (например, антивирусное программное обеспечение) могут вызвать дополнительные события файловой системы, обнаруженные FileSystemWatcher.
