FileSystemWatcher.InternalBufferSize Property
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Gets or sets the size (in bytes) of the internal buffer.
public:
property int InternalBufferSize { int get(); void set(int value); };public int InternalBufferSize { get; set; }[System.ComponentModel.Browsable(false)]
public int InternalBufferSize { get; set; }member this.InternalBufferSize : int with get, set[<System.ComponentModel.Browsable(false)>]
member this.InternalBufferSize : int with get, setPublic Property InternalBufferSize As IntegerProperty Value
The internal buffer size in bytes. The default is 8192 (8 KB).
- Attributes
Remarks
You can set the buffer to 4 KB or larger, but it must not exceed 64 KB. If you try to set the InternalBufferSize property to less than 4096 bytes, your value is discarded and the InternalBufferSize property is set to 4096 bytes. For best performance, use a multiple of 4 KB on Intel-based computers.
The system notifies the component of file changes, and it stores those changes in a buffer the component creates and passes to the APIs. Each event can use up to 16 bytes of memory, not including the file name. If there are many changes in a short time, the buffer can overflow. This causes the component to lose track of changes in the directory, and it will only provide blanket notification. Increasing the size of the buffer can prevent missing file system change events. However, increasing buffer size is expensive, because it comes from non-paged memory that cannot be swapped out to disk, so keep the buffer as small as possible. To avoid a buffer overflow, use the NotifyFilter and IncludeSubdirectories properties to filter out unwanted change notifications.
