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 -> unit
Public Overrides Sub Close ()
Ausnahmen
Die aktuelle Codierung unterstützt das Anzeigen einer Hälfte eines Unicode-Ersatzzeichenpaars nicht.
Beispiele
Im folgenden Codebeispiel wird die -Methode Close
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 Dispose auf, die einen -Wert true
über gibt.
Sie müssen Close aufrufen, um sicherzustellen, dass alle Daten ordnungsgemäß in den zugrunde liegenden Stream geschrieben werden. Nach einem Aufruf von Close können alle Vorgänge für den Ausnahmen StreamWriter auslösen. Wenn nicht genügend Speicherplatz auf dem Datenträger vorhanden ist, wird Close durch Aufrufen von eine Ausnahme ausgelöst.
Beim Leeren des Streams wird der zugrunde liegende Encoder nur geleert, wenn Sie explizit oder Flush Close aufrufen. Das Festlegen von auf bedeutet, dass Daten aus dem Puffer in den Stream geleert werden, der AutoFlush true
Encoderzustand jedoch nicht geleert wird. Dadurch kann der Encoder seinen Zustand (Teilzeichen) behalten, damit er den nächsten Zeichenblock ordnungsgemäß codieren kann. Dieses Szenario betrifft UTF8 und UTF7, wobei bestimmte Zeichen nur codiert werden können, nachdem der Encoder das bzw. die angrenzenden Zeichen empfangen hat.