Conceitos e Propriedades - Monitorando Arquivos e Diretórios com FileSystemWatcher - Parte 1

 O FileSystemWatcher é um componente nativo do .NET Framework que tem como função monitorar diretórios e árvores de diretórios disparando eventos e enviando notificações sobre quaisquer alterações que venham a ocorrer nestes diretórios. Desta forma, quando algum diretório ou subdiretório é criado, alterado, renomeado ou excluído, o FileSystemWatcher acaba funcionando como um “dedo duro” informando ao usuário estas ocorrências. Esse componente pode ser usado para monitorar um ou mais computadores locais, remotos ou em rede.

- As principais propriedades do FileSystemWatcher são:

- EnableRaisingEvents – o diretório só será monitorado se esta propriedade estiver “setada” como true.

- Path – será a pasta que será monitorada pelo nosso componente.

- IncludeSubDirectories – valor booleano, se deixarmos true, ele irá monitorar os subdiretórios.

- Filter – é a extensão do arquivo que nosso componente irá filtrar (.txt por exemplo). Se deixarmos o valor padrão (*.*), ele irá filtrar todos os arquivos.

- NotifyFilter – serão os atributos (ou gatilhos) que, ao serem alterados, farão com que nosso componente dispare um determinado evento que irá notificar o usuário que determinado arquivo ou diretório foi alterado.

- Atributos para os Filtros de Notificação (NotifyFilter):

- Attributes – o atributo do arquivo ou diretório.

- CreationTime – a hora que o arquivo ou diretório foi criado.

- DirectoryName – o nome do diretório.

- FileName – o nome do arquivo.

- LastAccess – a data da última abertura do arquivo ou diretório.

- LastWrite – a data da última escrita no arquivo ou diretório.

- Security – as configurações de segurança do arquivo ou diretório.

- Sobrecarga de Métodos:

 Temos três sobrecargas da classe do FileSystemWatcher, que são:

 1ª - Inicia uma nova instância da classe FileSystemWatcher:

FileSystemWatcher fsw = new FileSystemWatcher();

 2ª - Inicia uma nova instância da classe FileSystemWatcher passando como parâmetro a propriedade Path:

FileSystemWatcher fsw = new FileSystemWatcher(@"C:\pasta");

 3ª - Inicia uma nova instância da classe FileSystemWatcher passando como parâmetro as propriedades Path e Filter:

FileSystemWatcher fsw = new FileSystemWatcher(@"C:\pasta", "*.*");

- Eventos do FileSystemWatcher:

fsw.Changed += new FileSystemEventHandler(fsw_Changed);

fsw.Created += new FileSystemEventHandler(fsw_Created);

fsw.Deleted += new FileSystemEventHandler(fsw_Deleted);

fsw.Renamed += new RenamedEventHandler(fsw_Renamed);

 Estes serão os quatro eventos que usaremos em nosso exemplo.

- Eventos Disparados:

- Changed – disparado sempre que mudanças são feitas no tamanho, atributos, última escrita, último acesso ou permissões de segurança NTFS de um arquivo ou diretório.

- Created – disparado sempre que um diretório é criado.

- Deleted – disparado sempre que um diretório é excluído.

- Renamed – disparado sempre que o nome do diretório ou arquivo é alterado.

- Erro: Estouro de Buffer!

 Nosso componente pode receber um grande número de eventos simultâneos, principalmente se o mesmo estiver configurado para rodar em uma rede. Isso pode nos trazer alguns problemas: como o componente usa o Buffer para gerenciar esses eventos, se em um curto período de tempo o Buffer receber muitos eventos, pode ocorrer o erro de Estouro de Buffer, fazendo com que nosso componente perca os dados das alterações realizadas nas pastas e nos envie notificações em branco.

 Para que evitemos este erro, podemos usar o método WaitForChangedResult, que espera que um evento específico ocorra para que possa continuar a execução. Podemos definir este evento de acordo com os atributos especificados abaixo:

- All – A criação, exclusão, alteração ou mudança de nome de arquivo ou diretório.

- Changed – A mudança de arquivo ou diretório. Os tipos de mudança incluem: mudança de tamanho, atributos, definição de segurança, última escrita e hora do último acesso.

- Created – A criação de arquivo ou diretório.

- Deleted – A exclusão de arquivo ou diretório.

- Renamed – A mudança de nome de arquivo ou diretório.

 Então, se algum destes atributos acima for alterado, é disparado nosso evento.

 Na próxima parte iremos criar a aplicação e pôr em prática os conceitos apresentados aqui.

 Assim finalizo o artigo. Muito obrigado a todos!

 Um abraço, e até o próximo artigo

 Wellington Balbo de Camargo