FileSystemWatcher.IncludeSubdirectories Eigenschaft

Definition

Ruft einen Wert ab, der angibt, ob die Unterverzeichnisse im angegebenen Pfad überwacht werden sollen, oder legt diesen fest.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); };
[System.IO.IODescription("Flag to indicate we want to watch subdirectories")]
[System.IO.IODescription("FSW_IncludeSubdirectories")]
public bool IncludeSubdirectories { get; set; }
member this.IncludeSubdirectories : bool with get, set
Public Property IncludeSubdirectories As Boolean

Eigenschaftswert

true, wenn die Unterverzeichnisse überwacht werden sollen, andernfalls false.true if you want to monitor subdirectories; otherwise, false. Der Standardwert ist false.The default is false.

Attribute

Hinweise

Legen Sie IncludeSubdirectories auf true fest, wenn Sie auf Änderungs Benachrichtigungen für Dateien und Verzeichnisse überwachen möchten, die in dem Verzeichnis enthalten sind, das über die Eigenschaft Path und deren Unterverzeichnisse angegeben wird.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. Wenn Sie die IncludeSubdirectories-Eigenschaft auf false festlegen, verringern Sie die Anzahl der Benachrichtigungen, die an den internen Puffer gesendet werden.Setting the IncludeSubdirectories property to false helps reduce the number of notifications sent to the internal buffer. Weitere Informationen zum Herausfiltern unerwünschter Benachrichtigungen finden Sie unter den Eigenschaften NotifyFilter und InternalBufferSize.For more information on filtering out unwanted notifications, see the NotifyFilter and InternalBufferSize properties.

Wenn true, wird IncludeSubdirectories durch die gesamte Unterstruktur rekursiv, nicht nur die direkt untergeordneten Verzeichnisse.When true, IncludeSubdirectories is recursive through the entire sub tree, not just the immediate child directories. Der relative Pfad zu einer Datei oder einem Verzeichnis innerhalb der Teilstruktur wird in der Name-Eigenschaft von FileSystemEventArgs und der OldName-Eigenschaft von RenamedEventArgszurückgegeben, je nach den Änderungen, die Sie überwachen.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. Sie können den voll qualifizierten Pfad von der FullPath-Eigenschaft FileSystemEventArgs und der Eigenschaft OldFullPath von RenamedEventArgsabhängig von den Änderungen, die Sie überwachen, erhalten.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.

Wenn ein Verzeichnis in der Teilstruktur des zu überwachenden Verzeichnisses erstellt wird und IncludeSubdirectories trueist, wird dieses Verzeichnis automatisch überwacht.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.

Gilt für:

Siehe auch