Stream.Close-Methode

Artikel
08/20/2007

Schließt den aktuellen Stream und gibt alle dem aktuellen Stream zugeordneten Ressourcen frei (z. B. Sockets und Dateihandles).

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

Syntax

'Declaration
Public Overridable Sub Close
'Usage
Dim instance As Stream

instance.Close

public virtual void Close ()

public:
virtual void Close ()

public void Close ()

public function Close ()

Hinweise

Durch Entleeren des Streams wird der zugrunde liegende Codierer nicht entleert, wenn Sie nicht ausdrücklich eine Implementierung von Flush oder Close aufrufen. Wenn AutoFlush auf true festgelegt ist, werden Daten aus dem Puffer in den Stream entleert, aber der Codiererzustand wird nicht geleert. Dadurch kann der Codierer 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 Codierer das bzw. die angrenzenden Zeichen empfangen hat.

Ein Aufruf von Close ist für die ordnungsgemäße Funktion eines Streams erforderlich. Nach dem Aufruf von Close können andere Vorgänge im Stream Ausnahmen auslösen. Wenn der Stream bereits geschlossen ist, wird durch den Aufruf von Close keine Ausnahme ausgelöst.

Das Ändern des Streams nach dem Schließen des Streams kann eine ObjectDisposedException auslösen.

Hinweise für Implementierer Überschreiben Sie in abgeleiteten Klassen nicht die Close-Methode. Legen Sie stattdessen die gesamte Streambereinigungslogik in der Dispose-Methode ab. Weitere Informationen finden Sie unter Implementieren einer Dispose-Methode.

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

Stream-Klasse
Stream-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