FileSystemWatcher.IncludeSubdirectories-Eigenschaft

Artikel
08/20/2007

Ruft einen Wert ab, der angibt, ob die Unterverzeichnisse im angegebenen Pfad überwacht werden sollen, oder legt diesen fest.

Namespace: System.IO
Assembly: System (in system.dll)

Syntax

'Declaration
Public Property IncludeSubdirectories As Boolean
'Usage
Dim instance As FileSystemWatcher
Dim value As Boolean

value = instance.IncludeSubdirectories

instance.IncludeSubdirectories = value

public bool IncludeSubdirectories { get; set; }

public:
property bool IncludeSubdirectories {
    bool get ();
    void set (bool value);
}

/** @property */
public boolean get_IncludeSubdirectories ()

/** @property */
public void set_IncludeSubdirectories (boolean value)

public function get IncludeSubdirectories () : boolean

public function set IncludeSubdirectories (value : boolean)

Eigenschaftenwert

true, wenn die Unterverzeichnisse überwacht werden sollen, andernfalls false. Der Standardwert ist false.

Hinweise

Legen Sie IncludeSubdirectories auf true fest, um die Benachrichtigungen über Änderungen an Dateien und Verzeichnissen in dem durch die Path-Eigenschaft angegebenen Verzeichnis und dessen Unterverzeichnissen zu überwachen. Wenn Sie die IncludeSubdirectories-Eigenschaft auf false festlegen, verringern Sie die Anzahl der an den internen Puffer gesendeten Benachrichtigungen. Weitere Informationen zum Herausfiltern nicht erwünschter Benachrichtigungen finden Sie unter der NotifyFilter-Eigenschaft und der InternalBufferSize-Eigenschaft.

Bei true ist IncludeSubdirectories innerhalb der gesamten Teilstruktur rekursiv, nicht nur in den direkten Unterverzeichnissen. Der relative Pfad zu einer Datei oder einem Verzeichnis innerhalb der Teilstruktur wird je nach den überwachten Änderungen in der Name-Eigenschaft von FileSystemEventArgs oder der OldName-Eigenschaft von RenamedEventArgs zurückgegeben. Der voll gekennzeichnete Pfad kann je nach den überwachten Änderungen aus der FullPath-Eigenschaft von FileSystemEventArgs oder der OldFullPath-Eigenschaft von RenamedEventArgs abgerufen werden.

Wenn in der Teilstruktur des überwachten Verzeichnisses ein Verzeichnis erstellt wird, und IncludeSubdirectories den Wert true hat, wird dieses Verzeichnis automatisch überwacht.

Plattformen

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

FileSystemWatcher-Klasse
FileSystemWatcher-Member
System.IO-Namespace
NotifyFilter
FileSystemEventArgs-Klasse
FileSystemWatcher.Filter-Eigenschaft
FileSystemEventArgs.FullPath-Eigenschaft
RenamedEventArgs.OldFullPath
InternalBufferSize
FileSystemEventArgs.Name-Eigenschaft
RenamedEventArgs.OldName
Path
RenamedEventArgs

Freigeben über