StreamWriter.Close Methode

Definition

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

public:
 override void Close();
public override void Close();
override this.Close : unit -> unit
Public Overrides Sub Close ()

Ausnahmen

Die aktuelle Codierung unterstützt die Anzeige einer Hälfte eines Unicode-Ersatzpaars 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()

Hinweise

Diese Methode überschreibt Stream.Close.

Diese Implementierung der Close Methode, die Dispose einen true Wert übergibt.

Sie müssen aufrufen Close , um sicherzustellen, dass alle Daten ordnungsgemäß in den zugrunde liegenden Datenstrom geschrieben werden. Nach einem Aufruf von < a0/> können alle Vorgänge für die 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 Flush explizit auf oder Close. Die Einstellung AutoFlush bedeutet true , dass Daten aus dem Puffer in den Datenstrom geleert werden, der Encoderstatus wird jedoch nicht geleert. Dadurch kann der Encoder seinen Zustand (Teilzeichen) beibehalten, damit er den nächsten Zeichenblock richtig codieren kann. Dieses Szenario wirkt sich auf UTF8 und UTF7 aus, bei dem bestimmte Zeichen nur codiert werden können, nachdem der Encoder das angrenzende Zeichen oder zeichen empfängt.

Gilt für:

Weitere Informationen