FileSystemWatcher.InternalBufferSize Свойство

Определение

Пространство имен:

System.IO

Сборка:

System.IO.FileSystem.Watcher.dll

Исходный код:

FileSystemWatcher.cs

Получает или задает размер (в байтах) внутреннего буфера.

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

Значение свойства

Int32

Размер внутреннего буфера в байтах. Значение по умолчанию — 8192 (8 КБ).

Комментарии

Вы можете задать размер буфера размером 4 КБ или больше, но он не должен превышать 64 КБ. При попытке задать InternalBufferSize для свойства значение меньше 4096 байт, значение будет отменено, а InternalBufferSize для свойства задано значение 4096 байт. Для достижения оптимальной производительности используйте кратную 4 КБ на компьютерах с процессором Intel.

Система уведомляет компонент об изменениях файла и сохраняет эти изменения в буфере, который компонент создает и передает в API. Каждое событие может использовать до 16 байт памяти, не включая имя файла. Если за короткое время произошло много изменений, буфер может переполняться. Это приводит к тому, что компонент теряет отслеживание изменений в каталоге и будет предоставлять только общие уведомления. Увеличение размера буфера может предотвратить отсутствие событий изменения файловой системы. Тем не менее увеличение размера буфера является дорогостоящим, так как он поступает из нестраничной памяти, которую нельзя переключить на диск, поэтому используйте буфер как можно меньше. Чтобы избежать переполнения буфера, используйте NotifyFilter свойства и IncludeSubdirectories для фильтрации нежелательных уведомлений об изменениях.

См. также раздел

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