FileSystemWatcher.IncludeSubdirectories Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém ou define um valor que indica se as subpastas no caminho especificado devem ser monitoradas.
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; }
member this.IncludeSubdirectories : bool with get, set
[<System.IO.IODescription("FSW_IncludeSubdirectories")>]
member this.IncludeSubdirectories : bool with get, set
Public Property IncludeSubdirectories As Boolean
Valor da propriedade
true
se você quiser monitorar subdiretórios; caso contrário, false
. O padrão é false
.
- Atributos
Comentários
Defina IncludeSubdirectories como true
quando você quiser watch para notificações de alteração para arquivos e diretórios contidos no diretório especificado por meio da Path propriedade e seus subdiretórios. Definir a IncludeSubdirectories propriedade como false
ajuda a reduzir o número de notificações enviadas para o buffer interno. Para obter mais informações sobre como filtrar notificações indesejadas, consulte as NotifyFilter propriedades e InternalBufferSize .
Quando true
, IncludeSubdirectories é recursivo por toda a subárvore, não apenas os diretórios filho imediatos. O caminho relativo para um arquivo ou diretório dentro da subárvore retorna na Name propriedade de FileSystemEventArgs e na OldName propriedade de , dependendo das RenamedEventArgsalterações que você está observando. Você pode obter o caminho totalmente qualificado da FullPath propriedade de FileSystemEventArgs e da OldFullPath propriedade de RenamedEventArgs, dependendo das alterações que você está observando.
Se um diretório for criado na subárvore do diretório que você está assistindo e IncludeSubdirectories for true
, esse diretório será observado automaticamente.