StreamWriter.Close Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Schließt das aktuelle StreamWriter-Objekt und den zugrunde liegenden Stream.
public:
override void Close();public override void Close ();override this.Close : unit -> unitPublic Overrides Sub Close ()Ausnahmen
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.
