StreamWriter.Close Methode

Definition

Namespace:

System.IO

Assembly:

System.Runtime.dll

Quelle:

StreamWriter.cs

Schließt das aktuelle StreamWriter-Objekt und den zugrunde liegenden Stream.

public:
 override void Close();

public override void Close ();

override this.Close : unit -> unit

Public Overrides Sub Close ()

Ausnahmen

EncoderFallbackException

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

Beispiele

Im folgenden Codebeispiel wird die Close -Methode veranschaulicht.

// close the file by closing the writer
sw->Close();

// close the file by closing the writer
sw.Close();

' Close the file by closing the writer.
Sw.Close()

Hinweise

Diese Methode überschreibt Stream.Close.

Diese Implementierung von Close ruft die Methode auf, die Dispose einen true Wert übergibt.

Sie müssen aufrufen Close , um sicherzustellen, dass alle Daten ordnungsgemäß in den zugrunde liegenden Stream geschrieben werden. Nach einem Aufruf von Closekönnen alle Vorgänge auf dem StreamWriter Ausnahmen auslösen. Wenn auf dem Datenträger nicht genügend Speicherplatz vorhanden ist, löst der Aufruf Close eine Ausnahme aus.

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 aus dem Puffer in den Stream geleert werden, der Encoderzustand 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.

Weitere Informationen

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