StreamWriter.Flush Methode

Definition

Namespace:

System.IO

Assembly:

System.Runtime.dll

Quelle:

StreamWriter.cs

Löscht sämtliche Puffer für den aktuellen Writer und veranlasst die Ausgabe aller gepufferten Daten an den zugrunde liegenden Stream.

public:
 override void Flush();

public override void Flush ();

override this.Flush : unit -> unit

Public Overrides Sub Flush ()

Ausnahmen

ObjectDisposedException

Der aktuelle Writer wird geschlossen.

IOException

Ein E/A-Fehler ist aufgetreten.

EncoderFallbackException

Die aktuelle Codierung unterstützt das Anzeigen einer Hälfte eines Unicode-Ersatzzeichenpaars nicht.

Hinweise

Diese Methode überschreibt TextWriter.Flush.

Durch das Leeren des Datenstroms wird der zugrunde liegende Encoder nicht geleert, es sei denn, Sie rufen explizit oder auf FlushClose. Die Einstellung AutoFlush auf true bedeutet, dass Daten nach jedem Schreibvorgang aus dem Puffer in den Stream geleert werden, der Encoderstatus jedoch nicht geleert wird. Dadurch kann der Encoder seinen Zustand (Teilzeichen) beibehalten, sodass er den nächsten Zeichenblock ordnungsgemäß codieren kann. Dieses Szenario wirkt sich auf UTF8 und UTF7 aus, wobei bestimmte Zeichen erst codiert werden können, nachdem der Encoder die angrenzenden Zeichen empfangen hat.

Eine Liste allgemeiner E/A-Aufgaben finden Sie unter Allgemeine E/A-Aufgaben.

Weitere Informationen

• Close()
• Datei- und Stream-E/A
• How to: Lesen von Text aus einer Datei
• How to: Schreiben von Text in eine Datei