FileSystemWatcher.InternalBufferSize Eigenschaft

Definition

Ruft die Größe (in Byte) des internen Puffers ab oder legt diese fest.

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, set
Public Property InternalBufferSize As Integer

Eigenschaftswert

Int32

Die interne Puffergröße in Byte. Der Standardwert ist 8192 (8 KB).

Attribute

Hinweise

Sie können den Puffer auf 4 KB oder größer festlegen, darf aber nicht 64 KB überschreiten. Wenn Sie versuchen, die InternalBufferSize Eigenschaft auf weniger als 4096 Bytes festzulegen, wird Ihr Wert verworfen, und die InternalBufferSize Eigenschaft wird auf 4096 Bytes festgelegt. Verwenden Sie für optimale Leistung ein Vielfaches von 4 KB auf Intel-basierten Computern.

Das System benachrichtigt die Komponente von Dateiänderungen und speichert diese Änderungen in einem Puffer, den die Komponente erstellt und an die APIs übergibt. Jedes Ereignis kann bis zu 16 Bytes Arbeitsspeicher verwenden, nicht einschließlich des Dateinamens. Wenn es in kurzer Zeit viele Änderungen gibt, kann der Puffer überlaufen. Dies bewirkt, dass die Komponente die Nachverfolgung von Änderungen im Verzeichnis verliert, und sie stellt nur eine deckende Benachrichtigung bereit. Das Erhöhen der Größe des Puffers kann verhindern, dass fehlende Änderungsereignisse des Dateisystems fehlen. Die Erhöhung der Puffergröße ist jedoch teuer, da sie aus nicht seitenseitigem Arbeitsspeicher stammt, der nicht auf den Datenträger ausgetauscht werden kann, sodass der Puffer so klein wie möglich bleibt. Um einen Pufferüberlauf zu vermeiden, verwenden Sie die NotifyFilter und IncludeSubdirectories die Eigenschaften, um unerwünschte Änderungsbenachrichtigungen auszufiltern.

Gilt für

Siehe auch