FileSystemWatcher.InternalBufferSize-Eigenschaft

Artikel
08/20/2007

Ruft die Größe des internen Puffers ab oder legt diese fest.

Namespace: System.IO
Assembly: System (in system.dll)

Syntax

'Declaration
Public Property InternalBufferSize As Integer
'Usage
Dim instance As FileSystemWatcher
Dim value As Integer

value = instance.InternalBufferSize

instance.InternalBufferSize = value

public int InternalBufferSize { get; set; }

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

/** @property */
public int get_InternalBufferSize ()

/** @property */
public void set_InternalBufferSize (int value)

public function get InternalBufferSize () : int

public function set InternalBufferSize (value : int)

Eigenschaftenwert

Die Größe des internen Puffers. Die Standardeinstellung ist 8.192 Bytes (8 KB).

Hinweise

Der Puffer kann auf eine beliebige Größe über 4096 Bytes (4 KB) festgelegt werden. Bei Computern mit Intel-Prozessor wird jedoch die beste Leistung erzielt, wenn der Wert ein Vielfaches von 4 KB beträgt.

Das System benachrichtigt die Komponente über Dateiänderungen und speichert diese Änderungen in einem Puffer, der durch die Komponente erstellt und an die APIs übergeben wird. Wenn in kurzen Abständen Änderungen vorgenommen werden, kann es zu einem Überlauf des Puffers kommen. Dies führt dazu, dass die Komponente die Änderungen im Verzeichnis nicht mehr verfolgen kann. Die Komponente kann dann nur allgemeine Benachrichtigungen bereitstellen. Das Erhöhen der Puffergröße hat die folgenden Auswirkungen:

Durch das Erhöhen der Puffergröße können Sie verhindern, dass Dateisystemänderungs-Ereignisse verpasst werden. Hinweis: Wenn aufgrund von Abhängigkeiten mit Windows ein Ereignis nicht erfasst oder die Puffergröße überschritten wird, löst eine Instanz der FileSystemWatcher-Klasse kein Error-Ereignis aus.
Das Erhöhen der Puffergröße ist aufwändig, da Systemspeicher genutzt wird, der nicht auf die Festplatte ausgelagert werden kann. Der Puffer sollte deshalb so klein wie möglich gehalten werden. Um einen Überlauf des Puffers zu vermeiden, verwenden Sie die NotifyFilter-Eigenschaft und die IncludeSubdirectories-Eigenschaft, um nicht erwünschte Änderungsbenachrichtigungen herauszufiltern.

Plattformen

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

FileSystemWatcher-Klasse
FileSystemWatcher-Member
System.IO-Namespace
NotifyFilter
OnError
FileSystemWatcher.Filter-Eigenschaft
FileSystemWatcher.IncludeSubdirectories-Eigenschaft
InternalBufferOverflowException

Freigeben über