FileSystemWatcher.IncludeSubdirectories プロパティ
指定したパスのサブディレクトリを監視するかどうかを示す値を取得または設定します。
Public Property IncludeSubdirectories As Boolean
[C#]
public bool IncludeSubdirectories {get; set;}
[C++]
public: __property bool get_IncludeSubdirectories();public: __property void set_IncludeSubdirectories(bool);
[JScript]
public function get IncludeSubdirectories() : Boolean;public function set IncludeSubdirectories(Boolean);
プロパティ値
サブディレクトリを監視する場合は true 。それ以外の場合は false 。既定値は false です。
解説
Path プロパティで指定したディレクトリとそのサブディレクトリに含まれるファイルとディレクトリの変更通知をウォッチする場合は、 IncludeSubdirectories を true に設定します。 IncludeSubdirectories プロパティを false に設定すると、内部バッファに送られる通知の数が減少します。不必要な通知をフィルタで排除する方法の詳細については、 NotifyFilter プロパティと InternalBufferSize プロパティのトピックを参照してください。
true に設定した場合、 IncludeSubdirectories は直接の子ディレクトリだけでなく、サブツリー全体を再帰的にウォッチします。ウォッチしている変更によって異なりますが、 FileSystemEventArgs の Name プロパティおよび RenamedEventArgs の OldName プロパティに、サブツリー内のファイルまたはディレクトリの相対パスを返します。ウォッチしている変更によって異なりますが、 FileSystemEventArgs の FullPath プロパティと、 RenamedEventArgs の OldFullPath プロパティで絶対パスを取得できます。
ウォッチしているディレクトリのサブツリーにディレクトリが作成され、 IncludeSubdirectories が true の場合、そのディレクトリは自動的にウォッチされます。
必要条件
プラットフォーム: Windows NT Server 4.0, Windows NT Workstation 4.0, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ
参照
FileSystemWatcher クラス | FileSystemWatcher メンバ | System.IO 名前空間 | NotifyFilter | FileSystemEventArgs | Filter | FileSystemEventArgs.FullPath | RenamedEventArgs.OldFullPath | InternalBufferSize | FileSystemEventArgs.Name | RenamedEventArgs.OldName | Path | RenamedEventArgs