FileSystemWatcher.Error Событие

  • Ссылка

Определение

Пространство имен:
System.IO
Сборка:
System.IO.FileSystem.Watcher.dll
Сборка:
System.dll
Сборка:
netstandard.dll
Исходный код:
FileSystemWatcher.cs
Исходный код:
FileSystemWatcher.cs
Исходный код:
FileSystemWatcher.cs

Происходит, когда экземпляру 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

Тип события

ErrorEventHandler
Атрибуты
BrowsableAttribute

Комментарии

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

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

Примечание

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

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

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