FileSystemWatcher.Error Evento
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.
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;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
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 as 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 período 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 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
As 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 e alguns OnCreated eventos e OnDeleted 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.
