StreamWriter-Klasse

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 wird ohne Bytereihenfolgemarkierung (Byte-Order Mark, BOM) erstellt, sodass ihre GetPreamble-Methode ein leeres Bytearray zurückgibt. Wenn Sie einen StreamWriter mit UTF-8-Codierung und Bytereihenfolgemarkierung erstellen möchten, sollten Sie einen Konstruktor verwenden, der die Codierung angibt, z. B. StreamWriter(String, Boolean, Encoding).

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

Eine Liste allgemeiner E/A-Aufgaben finden Sie unter Allgemeine E/A-Aufgaben.

Im folgenden Beispiel wird gezeigt, wie ein StreamWriter-Objekt verwendet wird, um eine Datei zu schreiben, in der die Verzeichnisse auf dem Laufwerk C aufgeführt sind, und die dann ein StreamReader-Objekt verwendet, um jeden Verzeichnisnamen zu lesen und anzuzeigen. Im Allgemeinen ist es sinnvoll, diese Objekte in einer using-Anweisung zu verwenden, damit die nicht verwalteten Ressourcen ordnungsgemäß freigegeben werden. Die using-Anweisung ruft automatisch Dispose für das Objekt auf, wenn der Code, in dem das Objekt verwendet wird, abgeschlossen wurde.

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.IO;

namespace StreamReadWrite
{
    class Program
    {
        static void Main(string[] args)
        {
            // Get the directories currently on the C drive.
            DirectoryInfo[] cDirs = new DirectoryInfo(@"c:\").GetDirectories();

            // Write each directory name to a file.
            using (StreamWriter sw = new StreamWriter("CDriveDirs.txt"))
            {
                foreach (DirectoryInfo dir in cDirs)
                {
                    sw.WriteLine(dir.Name);

                }
            }

            // Read and show each line from the file.
            string line = "";
            using (StreamReader sr = new StreamReader("CDriveDirs.txt"))
            {
                while ((line = sr.ReadLine()) != null)
                {
                    Console.WriteLine(line);
                }
            }
        }
    }
}

.NET Framework

.NET Framework Client Profile

Windows 7, Windows Vista SP1 oder höher, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core wird nicht unterstützt), Windows Server 2008 R2 (Server Core wird mit SP1 oder höher unterstützt), Windows Server 2003 SP2

Referenz

Weitere Ressourcen