FileSystemWatcher.IncludeSubdirectories FileSystemWatcher.IncludeSubdirectories FileSystemWatcher.IncludeSubdirectories FileSystemWatcher.IncludeSubdirectories Property


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

 property bool IncludeSubdirectories { bool get(); void set(bool value); };
[System.IO.IODescription("Flag to indicate we want to watch subdirectories")]
public bool IncludeSubdirectories { get; set; }
member this.IncludeSubdirectories : bool with get, set
Public Property IncludeSubdirectories As Boolean


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


設定IncludeSubdirectoriestrueファイルとで指定されたディレクトリ内に含まれるディレクトリの変更通知を監視する場合、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. 不必要な通知をフィルター処理の詳細については、次を参照してください。、NotifyFilterInternalBufferSizeプロパティ。For more information on filtering out unwanted notifications, see the NotifyFilter and InternalBufferSize properties.

ときにtrueIncludeSubdirectoriesは直接の子ディレクトリだけでなく、全体のサブ ツリーを再帰的です。When true, IncludeSubdirectories is recursive through the entire sub tree, not just the immediate child directories. 内のファイルまたはサブツリー内のディレクトリへの相対パスを返します、NameプロパティのFileSystemEventArgsOldNameプロパティの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プロパティのFileSystemEventArgsOldFullPathプロパティの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.

ウォッチング中、ディレクトリのサブ ツリーで、ディレクトリを作成する場合とIncludeSubdirectoriestrue、そのディレクトリは自動的に監視します。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.