FileSystemWatcher.Error Evento
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Ocorre quando a instância de FileSystemWatcher não consegue continuar a monitorizar alterações ou quando o buffer interno transborda.
public:
event System::IO::ErrorEventHandler ^ Error;public event System.IO.ErrorEventHandler? Error;public event System.IO.ErrorEventHandler Error;[System.ComponentModel.Browsable(false)]
public event System.IO.ErrorEventHandler Error;member this.Error : System.IO.ErrorEventHandler [<System.ComponentModel.Browsable(false)>]
member this.Error : System.IO.ErrorEventHandler Public Custom Event Error As ErrorEventHandler Tipo de Evento
- Atributos
Observações
Este evento é ativado sempre que algo impede o FileSystemWatcher objeto de monitorizar alterações. Por exemplo, se o objeto estiver a monitorizar alterações num diretório remoto e a ligação a esse diretório for perdida, o Error evento é gerado.
O sistema notifica-te das alterações aos ficheiros e armazena essas alterações num buffer que o componente cria e passa para as APIs. Se houver muitas alterações num curto espaço de tempo, o buffer pode estourar. Isso faz com que o componente perca o controle das alterações no diretório e ele só fornecerá notificação geral. Aumentar o tamanho do buffer é caro, porque vem de memória não paginada que não pode ser trocada para o disco, por isso mantenha o buffer o mais pequeno possível. Para evitar um excesso de buffer, use , NotifyFilterFilter, e IncludeSubdirectories propriedades para filtrar notificações indesejadas de alteração.
Note
Operações comuns do sistema de arquivos podem gerar mais de um evento. Por exemplo, quando um ficheiro é movido de uma pasta para outra, podem ser gerados vários eventos OnChanged e alguns OnCreated e OnDeleted. Mover um arquivo é uma operação complexa que consiste em várias operações simples, portanto, gerando vários eventos. Da mesma forma, alguns aplicativos (por exemplo, software antivírus) podem causar eventos adicionais do sistema de arquivos que são detetados pelo FileSystemWatcher.
