(0) exportieren Drucken
Alle erweitern
Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen
Übersetzung
Original

StreamWriter-Klasse

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

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

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

Der StreamWriter-Typ macht die folgenden Member verfügbar.

  NameBeschreibung
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsStreamWriter(Stream)Initialisiert eine neue Instanz der StreamWriter-Klasse für den angegebenen Stream unter Verwedung UTF-8-Codierung und der Standardpuffergröße.
Öffentliche MethodeUnterstützt von XNA FrameworkStreamWriter(String)Initialisiert eine neue Instanz der StreamWriter-Klasse für die angegebene Datei unter Verwendung der Standardcodierung und -puffergröße.
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsStreamWriter(Stream, Encoding)Initialisiert eine neue Instanz der StreamWriter-Klasse für den angegebenen Stream unter Verwendung der angegebenen Codierung und der Standardpuffergröße.
Öffentliche MethodeUnterstützt von XNA FrameworkStreamWriter(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 angefügt werden. Wenn die Datei nicht vorhanden ist, erstellt dieser Konstruktor eine neue Datei.
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsStreamWriter(Stream, Encoding, Int32)Initialisiert eine neue Instanz der StreamWriter-Klasse für den angegebenen Stream unter Verwendung der angegebenen Codierung und Puffergröße.
Öffentliche MethodeUnterstützt von XNA FrameworkStreamWriter(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 angefügt werden. Wenn die Datei nicht vorhanden ist, erstellt dieser Konstruktor eine neue Datei.
Öffentliche MethodeUnterstützt in .NET für Windows Store-AppsStreamWriter(Stream, Encoding, Int32, Boolean)Initialisiert eine neue Instanz der StreamWriter-Klasse für den angegebenen Stream unter Verwendung der angegebenen Codierung und der Puffergröße und lässt optional den Stream geöffnet.
Öffentliche MethodeUnterstützt von XNA FrameworkStreamWriter(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 der Puffergröße. Wenn die Datei vorhanden ist, kann sie überschrieben oder angefügt werden. Wenn die Datei nicht vorhanden ist, erstellt dieser Konstruktor eine neue Datei.
Zum Seitenanfang

  NameBeschreibung
Öffentliche EigenschaftUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsAutoFlushRuft 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 fest.
Öffentliche EigenschaftUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsBaseStreamRuft den zugrunde liegenden Stream ab, der eine Schnittstelle zu einem Sicherungsspeicher bildet.
Öffentliche EigenschaftUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsEncodingRuft die Encoding ab, in der die Ausgabe geschrieben wird. (Überschreibt TextWriter.Encoding.)
Öffentliche EigenschaftUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsFormatProviderRuft ein Objekt zum Steuern der Formatierung ab. (Von TextWriter geerbt.)
Öffentliche EigenschaftUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsNewLineRuft die Zeichenfolge für den Zeilenabschluss ab, die vom aktuellen TextWriter verwendet wird, oder legt diese fest. (Von TextWriter geerbt.)
Zum Seitenanfang

  NameBeschreibung
Öffentliche MethodeUnterstützt von XNA FrameworkCloseSchließt das aktuelle StreamWriter-Objekt und den zugrunde liegenden Stream. (Überschreibt TextWriter.Close().)
Öffentliche MethodeCreateObjRefErstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind. (Von MarshalByRefObject geerbt.)
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsDispose()Gibt alle vom TextWriter-Objekt verwendeten Ressourcen frei. (Von TextWriter geerbt.)
Geschützte MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsDispose(Boolean)Gibt die von StreamWriter verwendeten nicht verwalteten Ressourcen und optional auch die verwalteten Ressourcen frei. (Überschreibt TextWriter.Dispose(Boolean).)
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsEquals(Object)Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist. (Von Object geerbt.)
Geschützte MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsFinalize Gibt einem Objekt Gelegenheit, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der Garbage Collection freigegeben wird. (Von Object geerbt.)
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsFlushLöscht sämtliche Puffer für den aktuellen Writer und veranlasst die Ausgabe aller gepufferten Daten an den zugrunde liegenden Stream. (Überschreibt TextWriter.Flush().)
Öffentliche MethodeUnterstützt in .NET für Windows Store-AppsFlushAsyncLöscht alle Puffer für diesen Stream asynchron und veranlasst die Ausgabe aller gepufferten Daten an das zugrunde liegende Gerät. (Überschreibt TextWriter.FlushAsync().)
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsGetHashCodeFungiert als die Standardhashfunktion. (Von Object geerbt.)
Öffentliche MethodeGetLifetimeServiceRuft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert. (Von MarshalByRefObject geerbt.)
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsGetTypeRuft den Type der aktuellen Instanz ab. (Von Object geerbt.)
Öffentliche MethodeInitializeLifetimeServiceRuft ein Lebensdauerdienstobjekt ab, mit dem die Lebensdauerrichtlinien für diese Instanz gesteuert werden können. (Von MarshalByRefObject geerbt.)
Geschützte MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsMemberwiseClone()Erstellt eine flache Kopie des aktuellen Object. (Von Object geerbt.)
Geschützte MethodeMemberwiseClone(Boolean)Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts. (Von MarshalByRefObject geerbt.)
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsToStringGibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Von Object geerbt.)
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsWrite(Boolean)Schreibt die Textdarstellung eines Boolean-Werts in die Textzeichenfolge oder den Stream. (Von TextWriter geerbt.)
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsWrite(Char)Schreibt ein Zeichen in den Stream. (Überschreibt TextWriter.Write(Char).)
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsWrite(Char[])Schreibt ein Zeichenarray in den Stream. (Überschreibt TextWriter.Write(Char[]).)
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsWrite(Decimal)Schreibt die Textdarstellung eines Dezimalwerts in die Textzeichenfolge oder den Stream. (Von TextWriter geerbt.)
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsWrite(Double)Schreibt die Textdarstellung eines 8-Byte-Gleitkommawerts in die Textzeichenfolge oder den Stream. (Von TextWriter geerbt.)
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsWrite(Int32)Schreibt die Textdarstellung einer 4-Byte-Ganzzahl mit Vorzeichen in die Textzeichenfolge oder den Stream. (Von TextWriter geerbt.)
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsWrite(Int64)Schreibt die Textdarstellung einer 8-Byte-Ganzzahl mit Vorzeichen in die Textzeichenfolge oder den Stream. (Von TextWriter geerbt.)
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsWrite(Object)Schreibt die Textdarstellung eines Objekts in die Textzeichenfolge oder den Stream, indem für das Objekt die ToString-Methode aufgerufen wird. (Von TextWriter geerbt.)
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsWrite(Single)Schreibt die Textdarstellung eines 4-Byte-Gleitkommawerts in die Textzeichenfolge oder den Stream. (Von TextWriter geerbt.)
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsWrite(String)Schreibt eine Zeichenfolge in den Stream. (Überschreibt TextWriter.Write(String).)
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsWrite(UInt32)Schreibt die Textdarstellung einer 4-Byte-Ganzzahl ohne Vorzeichen in die Textzeichenfolge oder den Stream. (Von TextWriter geerbt.)
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsWrite(UInt64)Schreibt die Textdarstellung einer 8-Byte-Ganzzahl ohne Vorzeichen in die Textzeichenfolge oder den Stream. (Von TextWriter geerbt.)
Öffentliche MethodeUnterstützt von XNA FrameworkWrite(String, Object)Schreibt eine formatierte Zeichenfolge in die Textzeichenfolge oder den Stream unter Verwendung der gleichen Semantik wie die String.Format(String, Object)-Methode. (Von TextWriter geerbt.)
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsWrite(String, Object[])Schreibt eine formatierte Zeichenfolge in die Textzeichenfolge oder den Stream unter Verwendung der gleichen Semantik wie die String.Format(String, Object[])-Methode. (Von TextWriter geerbt.)
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsWrite(Char[], Int32, Int32)Schreibt ein Unterarray von Zeichen in den Stream. (Überschreibt TextWriter.Write(Char[], Int32, Int32).)
Öffentliche MethodeUnterstützt von XNA FrameworkWrite(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. (Von TextWriter geerbt.)
Öffentliche MethodeWrite(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. (Von TextWriter geerbt.)
Öffentliche MethodeUnterstützt in .NET für Windows Store-AppsWriteAsync(Char)Schreibt ein Zeichen asynchron in den Stream. (Überschreibt TextWriter.WriteAsync(Char).)
Öffentliche MethodeUnterstützt in .NET für Windows Store-AppsWriteAsync(Char[])Schreibt ein Zeichenarray asynchron in die Textzeichenfolge oder den Stream. (Von TextWriter geerbt.)
Öffentliche MethodeUnterstützt in .NET für Windows Store-AppsWriteAsync(String)Schreibt eine Zeichenfolge asynchron in den Stream. (Überschreibt TextWriter.WriteAsync(String).)
Öffentliche MethodeUnterstützt in .NET für Windows Store-AppsWriteAsync(Char[], Int32, Int32)Schreibt ein Teilarray von Zeichen asynchron in den Stream. (Überschreibt TextWriter.WriteAsync(Char[], Int32, Int32).)
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsWriteLine()Schreibt ein Zeichen für den Zeilenabschluss in die Textzeichenfolge oder den Stream. (Von TextWriter geerbt.)
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsWriteLine(Boolean)Schreibt die Textdarstellung eines Boolean-Werts, gefolgt von einem Zeichen für den Zeilenabschluss, in die Textzeichenfolge oder den Stream. (Von TextWriter geerbt.)
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsWriteLine(Char)Schreibt ein Zeichen, gefolgt von einem Zeichen für den Zeilenabschluss, asynchron in die Textzeichenfolge oder den Stream. (Von TextWriter geerbt.)
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsWriteLine(Char[])Schreibt ein Array von Zeichen, gefolgt von einem Zeichen für den Zeilenabschluss, in die Textzeichenfolge oder den Stream. (Von TextWriter geerbt.)
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsWriteLine(Decimal)Schreibt die Textdarstellung eines Dezimalwerts, gefolgt von einem Zeichen für den Zeilenabschluss, in die Textzeichenfolge oder den Stream. (Von TextWriter geerbt.)
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsWriteLine(Double)Schreibt die Textdarstellung eines 8-Byte-Gleitkommawerts, gefolgt von einem Zeichen für den Zeilenabschluss, in die Zeichenfolge oder den Stream. (Von TextWriter geerbt.)
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsWriteLine(Int32)Schreibt die Textdarstellung einer 4-Byte-Ganzzahl mit Vorzeichen, gefolgt von einem Zeichen für den Zeilenabschluss, in die Textzeichenfolge oder den Stream. (Von TextWriter geerbt.)
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsWriteLine(Int64)Schreibt die Textdarstellung einer 8-Byte-Ganzzahl mit Vorzeichen, gefolgt von einem Zeichen für den Zeilenabschluss, in die Textzeichenfolge oder den Stream. (Von TextWriter geerbt.)
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsWriteLine(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. (Von TextWriter geerbt.)
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsWriteLine(Single)Schreibt die Textdarstellung eines 4-Byte-Gleitkommawerts, gefolgt von einem Zeichen für den Zeilenabschluss, in die Zeichenfolge oder den Stream. (Von TextWriter geerbt.)
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsWriteLine(String)Schreibt eine Zeichenfolge, gefolgt von einem Zeichen für den Zeilenabschluss, in die Textzeichenfolge oder den Stream. (Von TextWriter geerbt.)
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsWriteLine(UInt32)Schreibt die Textdarstellung einer 4-Byte-Ganzzahl ohne Vorzeichen, gefolgt von einem Zeichen für den Zeilenabschluss, in die Textzeichenfolge oder den Stream. (Von TextWriter geerbt.)
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsWriteLine(UInt64)Schreibt die Textdarstellung einer 8-Byte-Ganzzahl ohne Vorzeichen, gefolgt von einem Zeichen für den Zeilenabschluss, in die Textzeichenfolge oder den Stream. (Von TextWriter geerbt.)
Öffentliche MethodeUnterstützt von XNA FrameworkWriteLine(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. (Von TextWriter geerbt.)
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsWriteLine(String, Object[])Schreibt eine formatierte Zeichenfolge und eine neue Zeile unter Verwendung der gleichen Semantik wie bei Format. (Von TextWriter geerbt.)
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsWriteLine(Char[], Int32, Int32)Schreibt ein Teilarray von Zeichen, gefolgt von einem Zeichen für den Zeilenabschluss, in die Textzeichenfolge oder den Stream. (Von TextWriter geerbt.)
Öffentliche MethodeUnterstützt von XNA FrameworkWriteLine(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. (Von TextWriter geerbt.)
Öffentliche MethodeWriteLine(String, Object, Object, Object)Schreibt eine formatierte Zeichenfolge und eine neue Zeile unter Verwendung der gleichen Semantik wie bei Format. (Von TextWriter geerbt.)
Öffentliche MethodeUnterstützt in .NET für Windows Store-AppsWriteLineAsync()Schreibt ein Zeichen für den Zeilenabschluss asynchron in den Stream. (Überschreibt TextWriter.WriteLineAsync().)
Öffentliche MethodeUnterstützt in .NET für Windows Store-AppsWriteLineAsync(Char)Schreibt ein Zeichen, gefolgt von einem Zeichen für den Zeilenabschluss asynchron in den Stream. (Überschreibt TextWriter.WriteLineAsync(Char).)
Öffentliche MethodeUnterstützt in .NET für Windows Store-AppsWriteLineAsync(Char[])Schreibt ein Array von Zeichen, gefolgt von einem Zeichen für den Zeilenabschluss, asynchron in die Textzeichenfolge oder den Stream. (Von TextWriter geerbt.)
Öffentliche MethodeUnterstützt in .NET für Windows Store-AppsWriteLineAsync(String)Schreibt eine Zeichenfolge, gefolgt von einem Zeichen für den Zeilenabschluss, asynchron in den Stream. (Überschreibt TextWriter.WriteLineAsync(String).)
Öffentliche MethodeUnterstützt in .NET für Windows Store-AppsWriteLineAsync(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).)
Zum Seitenanfang

  NameBeschreibung
Geschütztes FeldUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsCoreNewLineSpeichert die für diesen TextWriter verwendeten Zeilenendemarken. (Von TextWriter geerbt.)
Öffentliches FeldStatischer MemberUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsNullStellt einen StreamWriter ohne Sicherungsspeicher bereit, in den zwar geschrieben, aus dem jedoch nicht gelesen werden kann.
Zum Seitenanfang

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

Wichtiger HinweisWichtig

Dieser Typ implementiert die IDisposable-Schnittstelle. Wenn die Verwendung des Typs haben, sollten Sie diesen direkt oder indirekt entweder freigeben. Um den Typ direkt zu löschen, rufen Sie die Dispose-Methode in einem try/catch-Block auf. So zeigen ihn indirekt freizugeben, verwenden Sie ein Sprachkonstrukt wie using (in C#) oder Using (in Visual Basic). Weitere Informationen finden Sie im Abschnitt "Verwenden eines Objekts, das Abschnitt IDisposable" im IDisposable-Schnittstellenthema implementiert.

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. Die Standard-UTF-8-Codierung für diesen Konstruktor löst eine Ausnahme auf ungültige Bytes aus. Dieses Verhalten ist mit dem Verhalten unterscheidet, das vom Codierungsobjekt in der Encoding.UTF8-Eigenschaft bereitgestellt wird. Um einer BOM anzugeben und zu bestimmen ob eine Ausnahme auf ungültige Bytes ausgelöst wird, verwenden Sie einen Konstruktor der ein Codierungsobjekt als Parameter, wie StreamWriter(String, Boolean, Encoding) oder StreamWriter akzeptiert.

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. Der Konstruktor, der in diesem Beispiel verwendet wird, ist nicht zur Verwendung in Windows Store-Apps unterstützt.


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

Unterstützt in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Unterstützt in: 4, 3.5 SP1

Portable Klassenbibliothek

Unterstützt in: Portable Klassenbibliothek

.NET für Windows Store-Apps

Unterstützt in: Windows 8

.NET für Windows Phone-Apps

Unterstützt in: Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

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

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

Community-Beiträge

HINZUFÜGEN
Anzeigen:
© 2014 Microsoft