Partilhar via


FileSystemWatcher.Error Evento

Definição

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.

Aplica-se a

Confira também