FileSystemWatcher.IncludeSubdirectories プロパティ

定義

指定したパスのサブディレクトリを監視するかどうかを示す値を取得または設定します。Gets or sets a value indicating whether subdirectories within the specified path should be monitored.

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; }
[System.IO.IODescription("Flag to indicate we want to watch subdirectories")]
public bool IncludeSubdirectories { get; set; }
member this.IncludeSubdirectories : bool with get, set
[<System.IO.IODescription("FSW_IncludeSubdirectories")>]
member this.IncludeSubdirectories : bool with get, set
[<System.IO.IODescription("Flag to indicate we want to watch subdirectories")>]
member this.IncludeSubdirectories : bool with get, set
Public Property IncludeSubdirectories As Boolean

プロパティ値

Boolean

サブディレクトリを監視する場合は true。それ以外の場合は falsetrue if you want to monitor subdirectories; otherwise, false. 既定値は、false です。The default is false.

属性

注釈

IncludeSubdirectoriesプロパティと true そのサブディレクトリによって指定されたディレクトリ内に含まれるファイルとディレクトリの変更通知を監視する場合は、に設定し Path ます。Set IncludeSubdirectories to true when you want to watch for change notifications for files and directories contained within the directory specified through the Path property, and its subdirectories. IncludeSubdirectoriesプロパティをに設定すると、 false 内部バッファーに送信される通知の数を減らすことができます。Setting the IncludeSubdirectories property to false helps reduce the number of notifications sent to the internal buffer. 不要な通知を除外する方法の詳細については、「」および「」プロパティを参照してください NotifyFilter InternalBufferSizeFor more information on filtering out unwanted notifications, see the NotifyFilter and InternalBufferSize properties.

trueの場合、 IncludeSubdirectories は直下の子ディレクトリだけでなく、サブツリー全体を再帰的に処理します。When true, IncludeSubdirectories is recursive through the entire sub tree, not just the immediate child directories. このサブツリー内のファイルまたはディレクトリへの相対パスは、 Name FileSystemEventArgs OldName RenamedEventArgs 監視している変更に応じて、のプロパティとのプロパティに戻ります。The relative path to a file or directory within the sub tree returns in the Name property of FileSystemEventArgs and the OldName property of RenamedEventArgs, depending on changes you are watching for. FullPath FileSystemEventArgs OldFullPath RenamedEventArgs 監視している変更に応じて、のプロパティとのプロパティから完全修飾パスを取得できます。You can get the fully qualified path from the FullPath property of FileSystemEventArgs and the OldFullPath property of RenamedEventArgs, depending on the changes you are watching for.

監視しているディレクトリのサブツリーにディレクトリが作成され、がである場合 IncludeSubdirectories true 、そのディレクトリは自動的に監視されます。If a directory is created in the sub tree of the directory you are watching, and IncludeSubdirectories is true, that directory will automatically be watched.

適用対象

こちらもご覧ください