FileSystemWatcher.InternalBufferSize Propriedade

Definição

Namespace:

System.IO

Assembly:

System.IO.FileSystem.Watcher.dll

Origem:

FileSystemWatcher.cs

Obtém ou define o tamanho (em bytes) do buffer interno.

public:
 property int InternalBufferSize { int get(); void set(int value); };

public int InternalBufferSize { get; set; }

member this.InternalBufferSize : int with get, set

Public Property InternalBufferSize As Integer

Valor da propriedade

Int32

O tamanho do buffer interno em bytes. O padrão é 8192 (8 KB).

Comentários

Você pode definir o buffer como 4 KB ou maior, mas ele não deve exceder 64 KB. Se você tentar definir a InternalBufferSize propriedade como menor que 4096 bytes, o valor será descartado e a InternalBufferSize propriedade será definida como 4096 bytes. Para obter o melhor desempenho, use um múltiplo de 4 KB em computadores baseados em Intel.

O sistema notifica o componente de alterações de arquivo e armazena essas alterações em um buffer que o componente cria e passa para as APIs. Cada evento pode usar até 16 bytes de memória, sem incluir o nome do arquivo. 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 pode evitar eventos de alteração do sistema de arquivos ausentes. No entanto, aumentar o tamanho do buffer é caro, pois ele vem da 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 NotifyFilter propriedades e IncludeSubdirectories para filtrar notificações de alteração indesejadas.

Confira também

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