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

属性

注解

true如果要为通过 Path 属性指定的目录及其子目录中包含的文件和目录watch更改通知,请将 设置为 IncludeSubdirectories 。 将 IncludeSubdirectories 属性设置为 false 有助于减少发送到内部缓冲区的通知数。 有关筛选掉不需要的通知的详细信息,请参阅 NotifyFilterInternalBufferSize 属性。

当 时 trueIncludeSubdirectories 将在整个子树(而不仅仅是直接子目录)中递归。 子树中文件或目录的相对路径将在 的 FileSystemEventArgs 属性和 OldNameRenamedEventArgs属性中Name返回,具体取决于要监视的更改。 可以从 的 属性和 的 属性FileSystemEventArgs获取完全限定的路径FullPath,具体取决于要监视的RenamedEventArgs更改。OldFullPath

如果在正在监视的目录的子树中创建目录,并且 IncludeSubdirectoriestrue,则会自动监视该目录。

适用于

另请参阅