StreamWriter-Klasse

Artikel
08/20/2007

Implementiert einen TextWriter zum Schreiben von Zeichen in einen Stream in einer bestimmten Codierung.

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

Syntax

'Declaration
<SerializableAttribute> _
<ComVisibleAttribute(True)> _
Public Class StreamWriter
    Inherits TextWriter
'Usage
Dim instance As StreamWriter

[SerializableAttribute] 
[ComVisibleAttribute(true)] 
public class StreamWriter : TextWriter

[SerializableAttribute] 
[ComVisibleAttribute(true)] 
public ref class StreamWriter : public TextWriter

/** @attribute SerializableAttribute() */ 
/** @attribute ComVisibleAttribute(true) */ 
public class StreamWriter extends TextWriter

SerializableAttribute 
ComVisibleAttribute(true) 
public class StreamWriter extends TextWriter

Hinweise

Mit StreamWriter werden Zeichen in einer bestimmten Codierung ausgegeben, wohingegen von Stream abgeleitete Klassen für die Byteeingabe und -ausgabe verwendet werden.

StreamWriter verwendet als Standard eine Instanz von UTF8Encoding, soweit dies nicht anders angegeben wird. Diese Instanz von UTF8Encoding wurde so erstellt, dass die Encoding.GetPreamble-Methode die Unicode-Bytereihenfolgemarkierung in UTF-8 zurückgibt. Die Präambel der Codierung wird einem Stream hinzugefügt, wenn Sie diese nicht an einen vorhandenen Stream anfügen. Dies bedeutet, dass jede mit StreamWriter erstellte Textdatei am Anfang über drei Markierungen für die Bytereihenfolge verfügt. UTF-8 bietet eine korrekte Behandlung aller Unicode-Zeichen richtig und konsistente Ergebnisse unter lokalisierten Versionen des Betriebssystems.

In der Standardeinstellung ist StreamWriter nicht threadsicher. Informationen über einen threadsicheren Wrapper finden Sie unter TextWriter.Synchronized.

In der folgenden Tabelle sind Beispiele für andere typische oder verwandte E/A-Aufgaben aufgeführt.

Aufgabe	Beispiel in diesem Thema
Eine Textdatei erstellen.	Gewusst wie: Schreiben von Text in eine Datei
In eine Textdatei schreiben.	Gewusst wie: Schreiben von Text in eine Datei
Aus einer Textdatei lesen.	Gewusst wie: Lesen aus einer Textdatei
Text an eine Datei anfügen.	Gewusst wie: Öffnen und Anfügen an eine Protokolldatei File.AppendText FileInfo.AppendText
Die Größe einer Datei abrufen.	FileInfo.Length
Die Attribute einer Datei abrufen.	File.GetAttributes
Die Attribute einer Datei festlegen.	File.SetAttributes
Bestimmen, ob eine Datei vorhanden ist.	File.Exists
Aus einer Binärdatei lesen.	Gewusst wie: Lesen und Schreiben einer neu erstellten Datendatei
In eine Binärdatei schreiben.	Gewusst wie: Lesen und Schreiben einer neu erstellten Datendatei

Vererbungshierarchie

System.Object
   System.MarshalByRefObject
     System.IO.TextWriter
      System.IO.StreamWriter

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

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-Member
System.IO-Namespace
Stream-Klasse
StreamReader-Klasse
Encoder
Encoding

Weitere Ressourcen

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

Freigeben über