Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

StreamWriter-Klasse

 

Veröffentlicht: Oktober 2016

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

Um den .NET Framework-Quellcode für diesen Typ zu durchsuchen, finden Sie unter der Reference Source.

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

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

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

NameBeschreibung
System_CAPS_pubmethodStreamWriter(Stream)

Initialisiert eine neue Instanz der StreamWriter-Klasse für den angegebenen Stream unter Verwendung der UTF-8-Codierung und der Standardpuffergröße.

System_CAPS_pubmethodStreamWriter(Stream, Encoding)

Initialisiert eine neue Instanz der StreamWriter-Klasse für den angegebenen Stream unter Verwendung der angegebenen Codierung und der Standardpuffergröße.

System_CAPS_pubmethodStreamWriter(Stream, Encoding, Int32)

Initialisiert eine neue Instanz der StreamWriter-Klasse für den angegebenen Stream unter Verwendung der angegebenen Codierung und Puffergröße.

System_CAPS_pubmethodStreamWriter(Stream, Encoding, Int32, Boolean)

Initialisiert eine neue Instanz der StreamWriter-Klasse für den angegebenen Stream unter Verwendung der angegebenen Codierung und Puffergröße und lässt optional den Stream geöffnet.

System_CAPS_pubmethodStreamWriter(String)

Initialisiert eine neue Instanz der StreamWriter-Klasse für die angegebene Datei unter Verwendung der Standardcodierung und -puffergröße.

System_CAPS_pubmethodStreamWriter(String, Boolean)

Initialisiert eine neue Instanz der StreamWriter-Klasse für die angegebene Datei unter Verwendung der Standardcodierung und -puffergröße. Wenn die Datei vorhanden ist, kann sie überschrieben oder an sie angefügt werden. Wenn die Datei nicht vorhanden ist, erstellt dieser Konstruktor eine neue Datei.

System_CAPS_pubmethodStreamWriter(String, Boolean, Encoding)

Initialisiert eine neue Instanz der StreamWriter-Klasse für die angegebene Datei unter Verwendung der angegebenen Codierung und Standardpuffergröße. Wenn die Datei vorhanden ist, kann sie überschrieben oder an sie angefügt werden. Wenn die Datei nicht vorhanden ist, erstellt dieser Konstruktor eine neue Datei.

System_CAPS_pubmethodStreamWriter(String, Boolean, Encoding, Int32)

Initialisiert für die angegebene Datei im angegebenen Pfad eine neue Instanz der StreamWriter-Klasse unter Verwendung der angegebenen Codierung und Puffergröße. Wenn die Datei vorhanden ist, kann sie überschrieben oder an sie angefügt werden. Wenn die Datei nicht vorhanden ist, erstellt dieser Konstruktor eine neue Datei.

NameBeschreibung
System_CAPS_pubpropertyAutoFlush

Ruft einen Wert ab, der angibt, ob der StreamWriter nach jedem Aufruf von StreamWriter.Write den Puffer in den zugrunde liegenden Stream wegschreibt, oder legt diesen Wert fest.

System_CAPS_pubpropertyBaseStream

Ruft den zugrunde liegenden Stream ab, der eine Schnittstelle zu einem Sicherungsspeicher bildet.

System_CAPS_pubpropertyEncoding

Ruft die Encoding ab, in der die Ausgabe geschrieben wird.(Überschreibt TextWriter.Encoding.)

System_CAPS_pubpropertyFormatProvider

Ruft ein Objekt zum Steuern der Formatierung ab.(Geerbt von „TextWriter“.)

System_CAPS_pubpropertyNewLine

Ruft die Zeichenfolge für den Zeilenabschluss ab, die vom aktuellen TextWriter verwendet wird, oder legt diese fest.(Geerbt von „TextWriter“.)

NameBeschreibung
System_CAPS_pubmethodClose()

Schließt das aktuelle StreamWriter-Objekt und den zugrunde liegenden Stream.(Überschreibt TextWriter.Close().)

System_CAPS_pubmethodCreateObjRef(Type)

Erstellt ein Objekt, das alle relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt verwendet die enthält.(Geerbt von „MarshalByRefObject“.)

System_CAPS_pubmethodDispose()

Gibt alle vom TextWriter-Objekt verwendeten Ressourcen frei.(Geerbt von „TextWriter“.)

System_CAPS_protmethodDispose(Boolean)

Gibt die von StreamWriter verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei.(Überschreibt TextWriter.Dispose(Boolean).)

System_CAPS_pubmethodEquals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.(Geerbt von „Object“.)

System_CAPS_protmethodFinalize()

Gibt einem Objekt Gelegenheit, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der Garbage Collection freigegeben wird. (Geerbt von „Object“.)

System_CAPS_pubmethodFlush()

Löscht sämtliche Puffer für den aktuellen Writer und veranlasst die Ausgabe aller gepufferten Daten an den zugrunde liegenden Stream.(Überschreibt TextWriter.Flush().)

System_CAPS_pubmethodFlushAsync()

Löscht alle Puffer für diesen Stream asynchron und veranlasst die Ausgabe aller gepufferten Daten an das zugrunde liegende Gerät.(Überschreibt TextWriter.FlushAsync().)

System_CAPS_pubmethodGetHashCode()

Fungiert als die Standardhashfunktion.(Geerbt von „Object“.)

System_CAPS_pubmethodGetLifetimeService()

Ruft das Dienstobjekt für aktuellen Lebensdauer, das steuert, die lebensdauerrichtlinie für diese Instanz ab.(Geerbt von „MarshalByRefObject“.)

System_CAPS_pubmethodGetType()

Ruft den Type der aktuellen Instanz ab.(Geerbt von „Object“.)

System_CAPS_pubmethodInitializeLifetimeService()

Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab.(Geerbt von „MarshalByRefObject“.)

System_CAPS_protmethodMemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.(Geerbt von „Object“.)

System_CAPS_protmethodMemberwiseClone(Boolean)

Erstellt eine flache Kopie des aktuellen MarshalByRefObject Objekt.(Geerbt von „MarshalByRefObject“.)

System_CAPS_pubmethodToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.(Geerbt von „Object“.)

System_CAPS_pubmethodWrite(Boolean)

Schreibt die Textdarstellung eines Boolean-Werts in die Textzeichenfolge oder den Stream.(Geerbt von „TextWriter“.)

System_CAPS_pubmethodWrite(Char)

Schreibt ein Zeichen in den Stream.(Überschreibt TextWriter.Write(Char).)

System_CAPS_pubmethodWrite(Char[])

Schreibt ein Zeichenarray in den Stream.(Überschreibt TextWriter.Write(Char[]).)

System_CAPS_pubmethodWrite(Char[], Int32, Int32)

Schreibt ein Teilarray von Zeichen in den Stream.(Überschreibt TextWriter.Write(Char[], Int32, Int32).)

System_CAPS_pubmethodWrite(Decimal)

Schreibt die Textdarstellung eines Dezimalwerts in die Textzeichenfolge oder den Stream.(Geerbt von „TextWriter“.)

System_CAPS_pubmethodWrite(Double)

Schreibt die Textdarstellung eines 8-Byte-Gleitkommawerts in die Textzeichenfolge oder den Stream.(Geerbt von „TextWriter“.)

System_CAPS_pubmethodWrite(Int32)

Schreibt die Textdarstellung einer 4-Byte-Ganzzahl mit Vorzeichen in die Textzeichenfolge oder den Stream.(Geerbt von „TextWriter“.)

System_CAPS_pubmethodWrite(Int64)

Schreibt die Textdarstellung einer 8-Byte-Ganzzahl mit Vorzeichen in die Textzeichenfolge oder den Stream.(Geerbt von „TextWriter“.)

System_CAPS_pubmethodWrite(Object)

Schreibt die Textdarstellung eines Objekts in die Textzeichenfolge oder den Stream, indem für das Objekt die ToString-Methode aufgerufen wird.(Geerbt von „TextWriter“.)

System_CAPS_pubmethodWrite(Single)

Schreibt die Textdarstellung eines 4-Byte-Gleitkommawerts in die Textzeichenfolge oder den Stream.(Geerbt von „TextWriter“.)

System_CAPS_pubmethodWrite(String)

Schreibt eine Zeichenfolge in den Stream.(Überschreibt TextWriter.Write(String).)

System_CAPS_pubmethodWrite(String, Object)

Schreibt eine formatierte Zeichenfolge in die Textzeichenfolge oder den Stream unter Verwendung der gleichen Semantik wie die String.Format(String, Object)-Methode.(Geerbt von „TextWriter“.)

System_CAPS_pubmethodWrite(String, Object, Object)

Schreibt eine formatierte Zeichenfolge in die Textzeichenfolge oder den Stream unter Verwendung der gleichen Semantik wie die String.Format(String, Object, Object)-Methode.(Geerbt von „TextWriter“.)

System_CAPS_pubmethodWrite(String, Object, Object, Object)

Schreibt eine formatierte Zeichenfolge in die Textzeichenfolge oder den Stream unter Verwendung der gleichen Semantik wie die String.Format(String, Object, Object, Object)-Methode.(Geerbt von „TextWriter“.)

System_CAPS_pubmethodWrite(String, Object[])

Schreibt eine formatierte Zeichenfolge in die Textzeichenfolge oder den Stream unter Verwendung der gleichen Semantik wie die String.Format(String, Object[])-Methode.(Geerbt von „TextWriter“.)

System_CAPS_pubmethodWrite(UInt32)

Schreibt die Textdarstellung einer 4-Byte-Ganzzahl ohne Vorzeichen in die Textzeichenfolge oder den Stream.(Geerbt von „TextWriter“.)

System_CAPS_pubmethodWrite(UInt64)

Schreibt die Textdarstellung einer 8-Byte-Ganzzahl ohne Vorzeichen in die Textzeichenfolge oder den Stream.(Geerbt von „TextWriter“.)

System_CAPS_pubmethodWriteAsync(Char)

Schreibt ein Zeichen asynchron in den Stream.(Überschreibt TextWriter.WriteAsync(Char).)

System_CAPS_pubmethodWriteAsync(Char[])

Schreibt ein Zeichenarray asynchron in die Textzeichenfolge oder den Stream.(Geerbt von „TextWriter“.)

System_CAPS_pubmethodWriteAsync(Char[], Int32, Int32)

Schreibt ein Teilarray von Zeichen asynchron in den Stream.(Überschreibt TextWriter.WriteAsync(Char[], Int32, Int32).)

System_CAPS_pubmethodWriteAsync(String)

Schreibt eine Zeichenfolge asynchron in den Stream.(Überschreibt TextWriter.WriteAsync(String).)

System_CAPS_pubmethodWriteLine()

Schreibt ein Zeichen für den Zeilenabschluss in die Textzeichenfolge oder den Stream.(Geerbt von „TextWriter“.)

System_CAPS_pubmethodWriteLine(Boolean)

Schreibt die Textdarstellung eines Boolean-Werts, gefolgt von einem Zeichen für den Zeilenabschluss, in die Textzeichenfolge oder den Stream.(Geerbt von „TextWriter“.)

System_CAPS_pubmethodWriteLine(Char)

Schreibt ein Zeichen, gefolgt von einem Zeichen für den Zeilenabschluss, in die Textzeichenfolge oder den Stream.(Geerbt von „TextWriter“.)

System_CAPS_pubmethodWriteLine(Char[])

Schreibt ein Array von Zeichen, gefolgt von einem Zeichen für den Zeilenabschluss, in die Textzeichenfolge oder den Stream.(Geerbt von „TextWriter“.)

System_CAPS_pubmethodWriteLine(Char[], Int32, Int32)

Schreibt ein Teilarray von Zeichen, gefolgt von einem Zeichen für den Zeilenabschluss, in die Textzeichenfolge oder den Stream.(Geerbt von „TextWriter“.)

System_CAPS_pubmethodWriteLine(Decimal)

Schreibt die Textdarstellung eines Dezimalwerts, gefolgt von einem Zeichen für den Zeilenabschluss, in die Textzeichenfolge oder den Stream.(Geerbt von „TextWriter“.)

System_CAPS_pubmethodWriteLine(Double)

Schreibt die Textdarstellung eines 8-Byte-Gleitkommawerts, gefolgt von einem Zeichen für den Zeilenabschluss, in die Zeichenfolge oder den Stream.(Geerbt von „TextWriter“.)

System_CAPS_pubmethodWriteLine(Int32)

Schreibt die Textdarstellung einer 4-Byte-Ganzzahl mit Vorzeichen, gefolgt von einem Zeichen für den Zeilenabschluss, in die Textzeichenfolge oder den Stream.(Geerbt von „TextWriter“.)

System_CAPS_pubmethodWriteLine(Int64)

Schreibt die Textdarstellung einer 8-Byte-Ganzzahl mit Vorzeichen, gefolgt von einem Zeichen für den Zeilenabschluss, in die Textzeichenfolge oder den Stream.(Geerbt von „TextWriter“.)

System_CAPS_pubmethodWriteLine(Object)

Schreibt durch Aufrufen der ToString-Methode für ein Objekt die Textdarstellung dieses Objekts, gefolgt von einem Zeichen für den Zeilenabschluss, in die Textzeichenfolge oder den Stream.(Geerbt von „TextWriter“.)

System_CAPS_pubmethodWriteLine(Single)

Schreibt die Textdarstellung eines 4-Byte-Gleitkommawerts, gefolgt von einem Zeichen für den Zeilenabschluss, in die Zeichenfolge oder den Stream.(Geerbt von „TextWriter“.)

System_CAPS_pubmethodWriteLine(String)

Schreibt eine Zeichenfolge, gefolgt von einem Zeichen für den Zeilenabschluss, in die Textzeichenfolge oder den Stream.(Geerbt von „TextWriter“.)

System_CAPS_pubmethodWriteLine(String, Object)

Schreibt eine formatierte Zeichenfolge und eine neue Zeile in die Textzeichenfolge oder den Stream unter Verwendung der gleichen Semantik wie die String.Format(String, Object)-Methode.(Geerbt von „TextWriter“.)

System_CAPS_pubmethodWriteLine(String, Object, Object)

Schreibt eine formatierte Zeichenfolge und eine neue Zeile in die Textzeichenfolge oder den Stream unter Verwendung der gleichen Semantik wie die String.Format(String, Object, Object)-Methode.(Geerbt von „TextWriter“.)

System_CAPS_pubmethodWriteLine(String, Object, Object, Object)

Schreibt eine formatierte Zeichenfolge und eine neue Zeile unter Verwendung der gleichen Semantik wie bei Format.(Geerbt von „TextWriter“.)

System_CAPS_pubmethodWriteLine(String, Object[])

Schreibt eine formatierte Zeichenfolge und eine neue Zeile unter Verwendung der gleichen Semantik wie bei Format.(Geerbt von „TextWriter“.)

System_CAPS_pubmethodWriteLine(UInt32)

Schreibt die Textdarstellung einer 4-Byte-Ganzzahl ohne Vorzeichen, gefolgt von einem Zeichen für den Zeilenabschluss, in die Textzeichenfolge oder den Stream.(Geerbt von „TextWriter“.)

System_CAPS_pubmethodWriteLine(UInt64)

Schreibt die Textdarstellung einer 8-Byte-Ganzzahl ohne Vorzeichen, gefolgt von einem Zeichen für den Zeilenabschluss, in die Textzeichenfolge oder den Stream.(Geerbt von „TextWriter“.)

System_CAPS_pubmethodWriteLineAsync()

Schreibt ein Zeichen für den Zeilenabschluss asynchron in den Stream.(Überschreibt TextWriter.WriteLineAsync().)

System_CAPS_pubmethodWriteLineAsync(Char)

Schreibt ein Zeichen, gefolgt von einem Zeichen für den Zeilenabschluss asynchron in den Stream.(Überschreibt TextWriter.WriteLineAsync(Char).)

System_CAPS_pubmethodWriteLineAsync(Char[])

Schreibt ein Array von Zeichen, gefolgt von einem Zeichen für den Zeilenabschluss, asynchron in die Textzeichenfolge oder den Stream.(Geerbt von „TextWriter“.)

System_CAPS_pubmethodWriteLineAsync(Char[], Int32, Int32)

Schreibt ein Teilarray von Zeichen, gefolgt von einem Zeichen für den Zeilenabschluss, asynchron in den Stream.(Überschreibt TextWriter.WriteLineAsync(Char[], Int32, Int32).)

System_CAPS_pubmethodWriteLineAsync(String)

Schreibt eine Zeichenfolge, gefolgt von einem Zeichen für den Zeilenabschluss, asynchron in den Stream.(Überschreibt TextWriter.WriteLineAsync(String).)

NameBeschreibung
System_CAPS_protfieldCoreNewLine

Speichert die für diesen TextWriter verwendeten Zeilenendemarken.(Geerbt von „TextWriter“.)

System_CAPS_pubfieldSystem_CAPS_staticNull

Stellt einen StreamWriter ohne Sicherungsspeicher bereit, in den zwar geschrieben, aus dem jedoch nicht gelesen werden kann.

System_CAPS_noteHinweis

Die .NET Framework-Quellcodes für diesen Typ finden Sie unter der Reference Source. Sie können den Quellcode online Durchsuchen, Referenz für die Offlineanzeige herunterladen und schrittweise durchlaufen (inklusive Patches und Updates) während des Debuggens; see instructions.

StreamWriter für die Zeichenausgabe in einer bestimmten Codierung entwickelt, während Klassen abgeleitete Stream eignen sich für die Eingabe und Ausgabe von Bytes.

System_CAPS_importantWichtig

Dieser Typ implementiert die IDisposable Schnittstelle. Wenn Sie mit dem Datentyp haben, sollten Sie es entweder direkt oder indirekt freigeben. Damit des Typs direkt freigegeben werden, rufen Sie seine Dispose -Methode in eine try/catch Block. Verwenden, um es indirekt freigegeben werden, z. B. ein Sprachkonstrukt using (in c#) oder Using (in Visual Basic). Weitere Informationen finden Sie im Abschnitt "Verwenden eines Objekts, die implementiert IDisposable" in der IDisposable Thema zur Schnittstelle.

StreamWriter Der Standardwert ist eine Instanz von UTF8Encoding sofern nicht anders angegeben. Diese Instanz von UTF8Encoding wird erstellt, ohne eine Byte Order Mark (BOM), also die GetPreamble -Methode gibt ein leeres Bytearray zurück. Der Standard-UTF-8-Codierung für diesen Konstruktor löst eine Ausnahme für ungültige Bytes. Dieses Verhalten unterscheidet sich vom Verhalten der Codierung-Objekts in die Encoding.UTF8 Eigenschaft. Geben Sie eine Bytereihenfolge-Marke, und bestimmen, ob ungültige Bytes eine Ausnahme ausgelöst wird, verwenden Sie einen Konstruktor, der ein Codierungsobjekt als Parameter, z. B. akzeptiert StreamWriter(String, Boolean, Encoding) oder StreamWriter.

In der Standardeinstellung eine StreamWriter ist nicht threadsicher. Finden Sie unter TextWriter.Synchronized für ein threadsicherer Wrapper.

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

Das folgende Beispiel zeigt, wie Sie ein StreamWriter -Objekt, das eine Datei zu schreiben, listet die Verzeichnisse auf dem Laufwerk C, und verwendet dann, ein StreamReader Objekt zum Lesen und Anzeigen der einzelnen Verzeichnisname. Eine gute Vorgehensweise ist die Verwendung dieser Objekte in einem using Anweisung, damit die nicht verwalteten Ressourcen ordnungsgemäß freigegeben werden. Die using -Anweisung ruft automatisch Dispose für das Objekt nach Abschluss der Code, der verwendet wird. In diesem Beispiel verwendete Konstruktor wird nicht unterstützt, für die Verwendung in Windows Store Apps.

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

Universelle Windows-Plattform
Verfügbar seit 8
.NET Framework
Verfügbar seit 1.1
Portierbare Klassenbibliothek
Unterstützt in: portierbare .NET-Plattformen
Silverlight
Verfügbar seit 2.0
Windows Phone Silverlight
Verfügbar seit 7.0
Windows Phone
Verfügbar seit 8.1

Alle öffentlichen statischen Member ( Shared in Visual Basic) dieses Typs sind threadsicher. Die Threadsicherheit für Instanzmember ist nicht garantiert.

Zurück zum Anfang
Anzeigen: