FileSystemWatcher.Error Evento

Definição

Namespace:

System.IO

Assembly:

System.IO.FileSystem.Watcher.dll

Origem:

FileSystemWatcher.cs

Ocorre quando a instância de FileSystemWatcher não pode continuar a monitorar alterações ou quando o buffer interno estoura.

public:
 event System::IO::ErrorEventHandler ^ Error;

public event System.IO.ErrorEventHandler? Error;

member this.Error : System.IO.ErrorEventHandler 

Public Custom Event Error As ErrorEventHandler 

Tipo de evento

ErrorEventHandler

Comentários

Esse evento é gerado sempre que algo impede que o FileSystemWatcher objeto monitore as alterações. Por exemplo, se o objeto estiver monitorando alterações em um diretório remoto e a conexão com esse diretório for perdida, o Error evento será gerado.

O sistema notifica você sobre alterações de arquivo e armazena essas alterações em um buffer que o componente cria e passa para as APIs. Se houver muitas alterações em um curto espaço de tempo, o buffer poderá estourar. Isso faz com que o componente perca o controle das alterações no diretório e fornecerá apenas uma notificação geral. Aumentar o tamanho do buffer é caro, pois ele vem de memória não paginada que não pode ser trocada para o disco, portanto, mantenha o buffer o menor possível. Para evitar um estouro de buffer, use as NotifyFilterpropriedades , Filtere IncludeSubdirectories para filtrar notificações de alteração indesejadas.

Observação

Operações comuns do sistema de arquivos podem gerar mais de um evento. Por exemplo, quando um arquivo é movido de um diretório para outro, vários OnChanged eventos e e OnDeletedOnCreated podem ser gerados. Mover um arquivo é uma operação complexa que consiste em várias operações simples, gerando, portanto, vários eventos. Da mesma forma, alguns aplicativos (por exemplo, software antivírus) podem causar eventos adicionais do sistema de arquivos detectados pelo FileSystemWatcher.

Confira também

• NotifyFilter
• ErrorEventArgs
• ErrorEventHandler
• Filter
• IncludeSubdirectories
• OnError(ErrorEventArgs)