StreamWriter.Close-Methode

Artikel
08/20/2007

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

Namespace: System.IO
Assembly: mscorlib (in mscorlib.dll)

Syntax

'Declaration
Public Overrides Sub Close
'Usage
Dim instance As StreamWriter

instance.Close

public override void Close ()

public:
virtual void Close () override

public void Close ()

public override function Close ()

Hinweise

Diese Methode überschreibt Close.

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

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 von StreamWriter Ausnahmen auslösen. Wenn auf dem Datenträger nicht genügend Speicherplatz vorhanden ist, wird beim Aufrufen von Close eine Ausnahme ausgelöst.

Durch Entleeren des Streams wird der zugrunde liegende Encoder nicht entleert, wenn Sie nicht ausdrücklich Flush oder Close aufrufen. Wenn AutoFlush auf true festgelegt ist, werden Daten aus dem Puffer in den Stream weggeschrieben, aber der Encoderzustand wird nicht entleert. Dadurch kann der Encoder seinen Zustand beibehalten (Teilzeichen), um den nächsten Block von Zeichen richtig zu codieren. Dieses Szenario betrifft UTF8 und UTF7, bei denen bestimmte Zeichen nur verschlüsselt werden können, nachdem der Encoder das bzw. die angrenzenden Zeichen empfangen hat.

Beispiel

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();

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

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

StreamWriter-Klasse
StreamWriter-Member
System.IO-Namespace

Weitere Ressourcen

Datei- und Stream-E/A
Gewusst wie: Lesen aus einer Textdatei
Gewusst wie: Schreiben von Text in eine Datei

Freigeben über