FileSystemWatcher.IncludeSubdirectories Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Получает или задает значение, показывающее необходимость контроля вложенных каталогов по указанному пути.
public:
property bool IncludeSubdirectories { bool get(); void set(bool value); };
public bool IncludeSubdirectories { get; set; }
[System.IO.IODescription("FSW_IncludeSubdirectories")]
public bool IncludeSubdirectories { get; set; }
member this.IncludeSubdirectories : bool with get, set
[<System.IO.IODescription("FSW_IncludeSubdirectories")>]
member this.IncludeSubdirectories : bool with get, set
Public Property IncludeSubdirectories As Boolean
Значение свойства
Значение true
, если требуется контроль вложенных каталогов; в противном случае — значение false
. Значение по умолчанию — false
.
- Атрибуты
Комментарии
Задайте значение IncludeSubdirectories , true
если требуется watch уведомлений об изменениях для файлов и каталогов, содержащихся в каталоге, указанном в свойстве Path , и его подкаталогах. Задание свойству IncludeSubdirectories значения false
помогает уменьшить количество уведомлений, отправляемых во внутренний буфер. Дополнительные сведения о фильтрации нежелательных уведомлений см. в свойствах NotifyFilter и InternalBufferSize .
Если true
задано значение , IncludeSubdirectories выполняет рекурсивную настройку по всему поддереву, а не только по непосредственным дочерним каталогам. Относительный путь к файлу или каталогу в поддереве возвращается в Name свойстве FileSystemEventArgs и OldName свойстве RenamedEventArgs, в зависимости от изменений, которые вы наблюдаете. Вы можете получить полный путь из FullPath свойства FileSystemEventArgs и OldFullPath свойства RenamedEventArgs, в зависимости от изменений, которые вы наблюдаете.
Если каталог создается в поддереве отслеживаемого каталога и IncludeSubdirectories имеет значение true
, этот каталог будет автоматически отслеживаться.