StreamWriter Klasse
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Implementiert eine TextWriter zum Schreiben von Zeichen in einen Datenstrom in einer bestimmten Codierung.
public ref class StreamWriter : System::IO::TextWriter
public class StreamWriter : System.IO.TextWriter
[System.Serializable]
public class StreamWriter : System.IO.TextWriter
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class StreamWriter : System.IO.TextWriter
type StreamWriter = class
inherit TextWriter
[<System.Serializable>]
type StreamWriter = class
inherit TextWriter
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type StreamWriter = class
inherit TextWriter
Public Class StreamWriter
Inherits TextWriter
- Vererbung
- Vererbung
- Attribute
Das folgende Beispiel zeigt, wie Sie ein StreamWriter-Objekt verwenden, um eine Datei zu schreiben, die die Verzeichnisse auf dem Laufwerk C auflistet, und verwendet dann ein StreamReader-Objekt, um jeden Verzeichnisnamen zu lesen und anzuzeigen. Es empfiehlt sich, diese Objekte in einer using
-Anweisung zu verwenden, damit die nicht verwalteten Ressourcen ordnungsgemäß verworfen werden. Die using
-Anweisung ruft automatisch Dispose für das Objekt auf, wenn der code, der sie verwendet, abgeschlossen ist. Der in diesem Beispiel verwendete Konstruktor wird für die Verwendung in Windows Store-Apps nicht 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);
}
}
}
}
}
Imports System.IO
Class Program
Shared Sub Main()
' Get the directories currently on the C drive.
Dim cDirs As DirectoryInfo() = New DirectoryInfo("c:\").GetDirectories()
' Write each directory name to a file.
Using sw As StreamWriter = New StreamWriter("CDriveDirs.txt")
For Each Dir As DirectoryInfo In cDirs
sw.WriteLine(Dir.Name)
Next
End Using
'Read and show each line from the file.
Dim line As String = ""
Using sr As StreamReader = New StreamReader("CDriveDirs.txt")
Do
line = sr.ReadLine()
Console.WriteLine(line)
Loop Until line Is Nothing
End Using
End Sub
End Class
StreamWriter ist für die Zeichenausgabe in einer bestimmten Codierung konzipiert, während Klassen, die von Stream abgeleitet werden, für Byteeingabe und -ausgabe ausgelegt sind.
Wichtig
Dieser Typ implementiert die IDisposable Schnittstelle. Wenn Sie die Verwendung des Typs abgeschlossen haben, sollten Sie ihn entweder direkt oder indirekt verwerfen. Rufen Sie zum direkten Löschen des Typs die Dispose-Methode in einem try
/catch
-Block auf. Verwenden Sie zum indirekten Löschen ein Sprachkonstrukt wie using
(in C#) oder Using
(in Visual Basic). Weitere Informationen finden Sie im Abschnitt "Verwenden eines Objekts, das IDisposable implementiert", im Thema zur IDisposable Schnittstelle.
StreamWriter wird standardmäßig eine Instanz von UTF8Encoding verwendet, sofern nicht anders angegeben. Diese Instanz von UTF8Encoding
wird ohne Bytereihenfolgezeichen (BYM) erstellt, sodass die GetPreamble-Methode ein leeres Bytearray zurückgibt. Die standardmäßige UTF-8-Codierung für diesen Konstruktor löst eine Ausnahme für ungültige Bytes aus. Dieses Verhalten unterscheidet sich vom Verhalten des Codierungsobjekts in der Encoding.UTF8-Eigenschaft. Verwenden Sie einen Konstruktor, der ein Codierungsobjekt als Parameter akzeptiert, z. B. StreamWriter(String, Boolean, Encoding) oder StreamWriter, um eine Ausnahme anzugeben und zu bestimmen, ob eine Ausnahme für ungültige Bytes ausgelöst wird.
Standardmäßig ist ein StreamWriter nicht threadsicher. Siehe TextWriter.Synchronized für einen threadsicheren Wrapper.
Eine Liste allgemeiner E/A-Aufgaben finden Sie unter Allgemeine E/A-Aufgaben.
Stream |
Initialisiert eine neue Instanz der StreamWriter Klasse für den angegebenen Datenstrom mithilfe der UTF-8-Codierung und der Standardpuffergröße. |
Stream |
Initialisiert eine neue Instanz der StreamWriter Klasse für den angegebenen Datenstrom mithilfe der angegebenen Codierung und der Standardpuffergröße. |
Stream |
Initialisiert eine neue Instanz der StreamWriter Klasse für den angegebenen Datenstrom mithilfe der angegebenen Codierungs- und Puffergröße. |
Stream |
Initialisiert eine neue Instanz der StreamWriter-Klasse für den angegebenen Datenstrom mithilfe der angegebenen Codierungs- und Puffergröße und lässt optional den Datenstrom geöffnet. |
Stream |
Initialisiert eine neue Instanz der StreamWriter Klasse für die angegebene Datei mithilfe der Standardcodierung und Puffergröße. |
Stream |
Initialisiert eine neue Instanz der StreamWriter Klasse für die angegebene Datei mithilfe der Standardcodierung und Puffergröße. Wenn die Datei vorhanden ist, kann sie entweder überschrieben oder angefügt werden. Wenn die Datei nicht vorhanden ist, erstellt dieser Konstruktor eine neue Datei. |
Stream |
Initialisiert eine neue Instanz der StreamWriter Klasse für die angegebene Datei mithilfe der angegebenen Codierungs- und Standardpuffergröße. Wenn die Datei vorhanden ist, kann sie entweder überschrieben oder angefügt werden. Wenn die Datei nicht vorhanden ist, erstellt dieser Konstruktor eine neue Datei. |
Stream |
Initialisiert eine neue Instanz der StreamWriter Klasse für die angegebene Datei im angegebenen Pfad unter Verwendung der angegebenen Codierungs- und Puffergröße. Wenn die Datei vorhanden ist, kann sie entweder überschrieben oder angefügt werden. Wenn die Datei nicht vorhanden ist, erstellt dieser Konstruktor eine neue Datei. |
Stream |
Initialisiert eine neue Instanz der StreamWriter Klasse für die angegebene Datei, wobei die angegebene Codierung verwendet und mit dem angegebenen FileStreamOptions -Objekt konfiguriert ist. |
Stream |
Initialisiert eine neue Instanz der StreamWriter-Klasse für die angegebene Datei, wobei die Standardcodierung verwendet und mit dem angegebenen FileStreamOptions -Objekt konfiguriert ist. |
Core |
Speichert die für diese |
Null |
Stellt eine |
Auto |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob der StreamWriter den Puffer nach jedem Aufruf von Write(Char)zum zugrunde liegenden Datenstrom leeren wird. |
Base |
Ruft den zugrunde liegenden Datenstrom ab, der über einen Sicherungsspeicher verfügt. |
Encoding |
Ruft die Encoding ab, in die die Ausgabe geschrieben wird. |
Format |
Ruft ein Objekt ab, das die Formatierung steuert. (Geerbt von TextWriter) |
New |
Dient zum Abrufen oder Festlegen der Zeilenterminatorzeichenfolge, die von der aktuellen |
Close() |
Schließt das aktuelle |
Close() |
Schließt den aktuellen Writer und gibt alle Systemressourcen frei, die dem Writer zugeordnet sind. (Geerbt von TextWriter) |
Create |
Erstellt ein Objekt, das alle relevanten Informationen enthält, die zum Generieren eines Proxys erforderlich sind, der für die Kommunikation mit einem Remoteobjekt verwendet wird. (Geerbt von MarshalByRefObject) |
Dispose() |
Gibt alle vom TextWriter-Objekt verwendeten Ressourcen frei. (Geerbt von TextWriter) |
Dispose(Boolean) |
Bewirkt, dass alle gepufferten Daten in den zugrunde liegenden Datenstrom geschrieben werden, die nicht verwalteten Ressourcen freigegeben werden, die vom StreamWriterverwendet werden, und optional die verwalteten Ressourcen. |
Dispose |
Schreibt asynchron alle gepufferten Daten in den zugrunde liegenden Datenstrom und gibt die nicht verwalteten Ressourcen frei, die vom StreamWriterverwendet werden. |
Dispose |
Gibt asynchron alle ressourcen frei, die vom TextWriter-Objekt verwendet werden. (Geerbt von TextWriter) |
Equals(Object) |
Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object) |
Finalize() |
Gibt die Ressourcen der aktuellen StreamWriter frei, bevor sie vom Garbage Collector beansprucht wird. |
Flush() |
Löscht alle Puffer für den aktuellen Writer und bewirkt, dass alle gepufferten Daten in den zugrunde liegenden Datenstrom geschrieben werden. |
Flush |
Löscht alle Puffer für diesen Datenstrom asynchron und bewirkt, dass alle gepufferten Daten auf das zugrunde liegende Gerät geschrieben werden. |
Flush |
Löscht asynchron alle Puffer für den aktuellen Writer und bewirkt, dass alle gepufferten Daten auf das zugrunde liegende Gerät geschrieben werden. (Geerbt von TextWriter) |
Flush |
Löscht alle Puffer für diesen Datenstrom asynchron und bewirkt, dass alle gepufferten Daten auf das zugrunde liegende Gerät geschrieben werden. |
Flush |
Löscht asynchron alle Puffer für den aktuellen Writer und bewirkt, dass alle gepufferten Daten auf das zugrunde liegende Gerät geschrieben werden. (Geerbt von TextWriter) |
Get |
Dient als Standardhashfunktion. (Geerbt von Object) |
Get |
Veraltet.
Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinie für diese Instanz steuert. (Geerbt von MarshalByRefObject) |
Get |
Ruft die Type der aktuellen Instanz ab. (Geerbt von Object) |
Initialize |
Veraltet.
Ruft ein Lebensdauerdienstobjekt ab, um die Lebensdauerrichtlinie für diese Instanz zu steuern. (Geerbt von MarshalByRefObject) |
Memberwise |
Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object) |
Memberwise |
Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts. (Geerbt von MarshalByRefObject) |
To |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |
Write(Boolean) |
Schreibt die Textdarstellung eines |
Write(Char) |
Schreibt ein Zeichen in den Datenstrom. |
Write(Char[]) |
Schreibt ein Zeichenarray in den Datenstrom. |
Write(Char[], Int32, Int32) |
Schreibt ein Unterarray von Zeichen in den Datenstrom. |
Write(Decimal) |
Schreibt die Textdarstellung eines Dezimalwerts in den Textstream. (Geerbt von TextWriter) |
Write(Double) |
Schreibt die Textdarstellung eines 8-Byte-Gleitkommawerts in den Textstream. (Geerbt von TextWriter) |
Write(Int32) |
Schreibt die Textdarstellung einer 4-Byte-Ganzzahl in den Textstream. (Geerbt von TextWriter) |
Write(Int64) |
Schreibt die Textdarstellung einer 8-Byte-Ganzzahl in den Textstream. (Geerbt von TextWriter) |
Write(Object) |
Schreibt die Textdarstellung eines Objekts in den Textstream, indem die |
Write(Read |
Schreibt einen Zeichenbereich in den Datenstrom. |
Write(Read |
Schreibt einen Zeichenbereich in den Textstream. (Geerbt von TextWriter) |
Write(Single) |
Schreibt die Textdarstellung eines 4-Byte-Gleitkommawerts in den Textstream. (Geerbt von TextWriter) |
Write(String) |
Schreibt eine Zeichenfolge in den Datenstrom. |
Write(String, Object) |
Schreibt eine formatierte Zeichenfolge in den Datenstrom, wobei die gleiche Semantik wie die Format(String, Object)-Methode verwendet wird. |
Write(String, Object) |
Schreibt eine formatierte Zeichenfolge in den Textstream, wobei die gleiche Semantik wie die Format(String, Object)-Methode verwendet wird. (Geerbt von TextWriter) |
Write(String, Object, Object) |
Schreibt eine formatierte Zeichenfolge mit der gleichen Semantik wie die Format(String, Object, Object)-Methode in den Datenstrom. |
Write(String, Object, Object) |
Schreibt eine formatierte Zeichenfolge mit derselben Semantik wie die Format(String, Object, Object)-Methode in den Textstream. (Geerbt von TextWriter) |
Write(String, Object, Object, Object) |
Schreibt eine formatierte Zeichenfolge in den Datenstrom, wobei die gleiche Semantik wie die Format(String, Object, Object, Object)-Methode verwendet wird. |
Write(String, Object, Object, Object) |
Schreibt eine formatierte Zeichenfolge in den Textstream, wobei die gleiche Semantik wie die Format(String, Object, Object, Object)-Methode verwendet wird. (Geerbt von TextWriter) |
Write(String, Object[]) |
Schreibt eine formatierte Zeichenfolge in den Datenstrom, wobei die gleiche Semantik wie die Format(String, Object[])-Methode verwendet wird. |
Write(String, Object[]) |
Schreibt eine formatierte Zeichenfolge in den Textstream, wobei die gleiche Semantik wie die Format(String, Object[])-Methode verwendet wird. (Geerbt von TextWriter) |
Write(String, Read |
Schreibt eine formatierte Zeichenfolge in den Datenstrom, wobei die gleiche Semantik wie Format(String, ReadOnlySpan<Object>)verwendet wird. |
Write(String, Read |
Schreibt eine formatierte Zeichenfolge in den Textstream, wobei die gleiche Semantik wie Format(String, ReadOnlySpan<Object>)verwendet wird. (Geerbt von TextWriter) |
Write(String |
Schreibt einen Zeichenfolgen-Generator in den Textstream. (Geerbt von TextWriter) |
Write(UInt32) |
Schreibt die Textdarstellung einer 4-Byte-Ganzzahl ohne Vorzeichen in den Textstream. (Geerbt von TextWriter) |
Write(UInt64) |
Schreibt die Textdarstellung einer 8-Byte-Ganzzahl ohne Vorzeichen in den Textstream. (Geerbt von TextWriter) |
Write |
Schreibt asynchron ein Zeichen in den Datenstrom. |
Write |
Schreibt asynchron ein Zeichen in den Textstream. (Geerbt von TextWriter) |
Write |
Schreibt asynchron ein Zeichenarray in den Textstream. (Geerbt von TextWriter) |
Write |
Schreibt asynchron eine Unterarray von Zeichen in den Datenstrom. |
Write |
Schreibt asynchron ein Unterarray von Zeichen in den Textstream. (Geerbt von TextWriter) |
Write |
Schreibt asynchron einen Zeichenspeicherbereich in den Datenstrom. |
Write |
Schreibt asynchron einen Zeichenspeicherbereich in den Textstream. (Geerbt von TextWriter) |
Write |
Schreibt asynchron eine Zeichenfolge in den Datenstrom. |
Write |
Schreibt eine Zeichenfolge asynchron in den Textstream. (Geerbt von TextWriter) |
Write |
Schreibt asynchron einen Zeichenfolgen-Generator in den Textstream. (Geerbt von TextWriter) |
Write |
Schreibt einen Zeilenendpunkt in den Textstream. (Geerbt von TextWriter) |
Write |
Schreibt die Textdarstellung eines |
Write |
Schreibt ein Zeichen in den Textstream, gefolgt von einem Zeilenterminator. (Geerbt von TextWriter) |
Write |
Schreibt ein Array von Zeichen in den Textstream, gefolgt von einem Zeilenterminator. (Geerbt von TextWriter) |
Write |
Schreibt eine Unterarray von Zeichen in den Textstream, gefolgt von einem Zeilenterminator. (Geerbt von TextWriter) |
Write |
Schreibt die Textdarstellung eines Dezimalwerts in den Textstream, gefolgt von einem Zeilenterminator. (Geerbt von TextWriter) |
Write |
Schreibt die Textdarstellung eines 8-Byte-Gleitkommawerts in den Textstream, gefolgt von einem Zeilenterminator. (Geerbt von TextWriter) |
Write |
Schreibt die Textdarstellung einer 4-Byte-Ganzzahl in den Textstream, gefolgt von einem Zeilenterminator. (Geerbt von TextWriter) |
Write |
Schreibt die Textdarstellung einer 8-Byte-Ganzzahl in den Textstream, gefolgt von einem Zeilenterminator. (Geerbt von TextWriter) |
Write |
Schreibt die Textdarstellung eines Objekts in den Textstream, indem die |
Write |
Schreibt die Textdarstellung eines Zeichenbereichs in den Datenstrom, gefolgt von einem Zeilenterminator. |
Write |
Schreibt die Textdarstellung eines Zeichenbereichs in den Textstream, gefolgt von einem Zeilenterminator. (Geerbt von TextWriter) |
Write |
Schreibt die Textdarstellung eines 4-Byte-Gleitkommawerts in den Textstream, gefolgt von einem Zeilenterminator. (Geerbt von TextWriter) |
Write |
Schreibt eine Zeichenfolge in den Datenstrom, gefolgt von einem Zeilenterminator. |
Write |
Schreibt eine Zeichenfolge in den Textstream, gefolgt von einem Zeilenterminator. (Geerbt von TextWriter) |
Write |
Schreibt eine formatierte Zeichenfolge und eine neue Zeile in den Datenstrom, wobei die gleiche Semantik wie die Format(String, Object)-Methode verwendet wird. |
Write |
Schreibt eine formatierte Zeichenfolge und eine neue Zeile in den Textstream, wobei die gleiche Semantik wie die Format(String, Object)-Methode verwendet wird. (Geerbt von TextWriter) |
Write |
Schreibt eine formatierte Zeichenfolge und eine neue Zeile in den Datenstrom, wobei die gleiche Semantik wie die Format(String, Object, Object)-Methode verwendet wird. |
Write |
Schreibt eine formatierte Zeichenfolge und eine neue Zeile in den Textstream, wobei die gleiche Semantik wie die Format(String, Object, Object)-Methode verwendet wird. (Geerbt von TextWriter) |
Write |
Schreibt eine formatierte Zeichenfolge und eine neue Zeile in den Datenstrom, wobei die gleiche Semantik wie Format(String, Object)verwendet wird. |
Write |
Schreibt eine formatierte Zeichenfolge und eine neue Zeile in den Textstream, wobei die gleiche Semantik wie Format(String, Object)verwendet wird. (Geerbt von TextWriter) |
Write |
Schreibt eine formatierte Zeichenfolge und eine neue Zeile in den Datenstrom, wobei die gleiche Semantik wie Format(String, Object)verwendet wird. |
Write |
Schreibt eine formatierte Zeichenfolge und eine neue Zeile in den Textstream, wobei die gleiche Semantik wie Format(String, Object)verwendet wird. (Geerbt von TextWriter) |
Write |
Schreibt eine formatierte Zeichenfolge und eine neue Zeile in den Datenstrom, wobei die gleiche Semantik wie Format(String, ReadOnlySpan<Object>)verwendet wird. |
Write |
Schreibt eine formatierte Zeichenfolge und eine neue Zeile in den Textstream, wobei die gleiche Semantik wie Format(String, ReadOnlySpan<Object>)verwendet wird. (Geerbt von TextWriter) |
Write |
Schreibt die Textdarstellung eines Zeichenfolgen-Generators in den Textstream, gefolgt von einem Zeilenterminator. (Geerbt von TextWriter) |
Write |
Schreibt die Textdarstellung einer 4-Byte-Ganzzahl ohne Vorzeichen in den Textstream, gefolgt von einem Zeilenterminator. (Geerbt von TextWriter) |
Write |
Schreibt die Textdarstellung einer 8-Byte-Ganzzahl ohne Vorzeichen in den Textstream, gefolgt von einem Zeilenterminator. (Geerbt von TextWriter) |
Write |
Schreibt asynchron einen Zeilenterminator in den Datenstrom. |
Write |
Schreibt asynchron einen Zeilenterminator in den Textstream. (Geerbt von TextWriter) |
Write |
Schreibt asynchron ein Zeichen in den Datenstrom, gefolgt von einem Zeilenterminator. |
Write |
Schreibt asynchron ein Zeichen in den Textstream, gefolgt von einem Zeilenterminator. (Geerbt von TextWriter) |
Write |
Schreibt asynchron ein Array von Zeichen in den Textstream, gefolgt von einem Zeilenterminator. (Geerbt von TextWriter) |
Write |
Schreibt asynchron eine Unterarray von Zeichen in den Datenstrom, gefolgt von einem Zeilenterminator. |
Write |
Schreibt asynchron eine Unterarray von Zeichen in den Textstream, gefolgt von einem Zeilenterminator. (Geerbt von TextWriter) |
Write |
Schreibt asynchron die Textdarstellung eines Zeichenspeicherbereichs in den Datenstrom, gefolgt von einem Zeilenterminator. |
Write |
Schreibt asynchron die Textdarstellung eines Zeichenspeicherbereichs in den Textstream, gefolgt von einem Zeilenterminator. (Geerbt von TextWriter) |
Write |
Schreibt asynchron eine Zeichenfolge in den Datenstrom, gefolgt von einem Zeilenterminator. |
Write |
Schreibt asynchron eine Zeichenfolge in den Textstream, gefolgt von einem Zeilenterminator. (Geerbt von TextWriter) |
Write |
Schreibt asynchron die Textdarstellung eines Zeichenfolgen-Generators in den Textstream, gefolgt von einem Zeilenterminator. (Geerbt von TextWriter) |
IDisposable. |
Eine Beschreibung dieses Mitglieds finden Sie unter Dispose(). (Geerbt von TextWriter) |
Configure |
Konfiguriert, wie auf die von einem asynchronen Einweg zurückgegebenen Aufgaben gewartet wird. |
Produkt | Versionen |
---|---|
.NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
.NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET Standard | 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1 |
UWP | 10.0 |
Feedback zu .NET
.NET ist ein Open Source-Projekt. Wählen Sie einen Link aus, um Feedback zu geben: