TextWriter Klasse
Definition
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.
Stellt einen Writer dar, der eine sequenzielle Reihe von Zeichen schreiben kann. Diese Klasse ist abstrakt.
public ref class TextWriter abstract : IDisposable
public ref class TextWriter abstract : MarshalByRefObject, IAsyncDisposable, IDisposable
public ref class TextWriter abstract : MarshalByRefObject, IDisposable
public abstract class TextWriter : IDisposable
public abstract class TextWriter : MarshalByRefObject, IAsyncDisposable, IDisposable
public abstract class TextWriter : MarshalByRefObject, IDisposable
[System.Serializable]
public abstract class TextWriter : MarshalByRefObject, IDisposable
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public abstract class TextWriter : MarshalByRefObject, IDisposable
type TextWriter = class
interface IDisposable
type TextWriter = class
inherit MarshalByRefObject
interface IAsyncDisposable
interface IDisposable
type TextWriter = class
inherit MarshalByRefObject
interface IDisposable
[<System.Serializable>]
type TextWriter = class
inherit MarshalByRefObject
interface IDisposable
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type TextWriter = class
inherit MarshalByRefObject
interface IDisposable
Public MustInherit Class TextWriter
Implements IDisposable
Public MustInherit Class TextWriter
Inherits MarshalByRefObject
Implements IAsyncDisposable, IDisposable
Public MustInherit Class TextWriter
Inherits MarshalByRefObject
Implements IDisposable
- Vererbung
-
TextWriter
- Vererbung
- Abgeleitet
- Attribute
- Implementiert
Beispiele
Die TextWriter Klasse ist eine abstrakte Klasse. Daher instanziieren Sie sie nicht in Ihrem Code. Die StreamWriter-Klasse wird von TextWriter abgeleitet und stellt Implementierungen der Member zum Schreiben in einen Datenstrom bereit. Das folgende Beispiel zeigt, wie Sie zwei Zeilen schreiben, die aus Zeichenfolgenwerten in eine Textdatei bestehen, indem Sie die WriteLineAsync(String)-Methode verwenden.
using System.IO;
namespace ConsoleApplication
{
class Program4
{
static void Main()
{
WriteCharacters();
}
static async void WriteCharacters()
{
using (StreamWriter writer = File.CreateText("newfile.txt"))
{
await writer.WriteLineAsync("First line of example");
await writer.WriteLineAsync("and second line");
}
}
}
}
Imports System.IO
Imports System.Text
Module Module1
Sub Main()
WriteCharacters()
End Sub
Async Sub WriteCharacters()
Using writer As StreamWriter = File.CreateText("newfile.txt")
Await writer.WriteLineAsync("First line of example")
Await writer.WriteLineAsync("and second line")
End Using
End Sub
End Module
Hinweise
TextWriter ist die abstrakte Basisklasse von StreamWriter und StringWriter, die Zeichen in Datenströme bzw. Zeichenfolgen schreiben. Verwenden Sie eine Instanz von TextWriter, um ein Objekt in eine Zeichenfolge zu schreiben, Zeichenfolgen in eine Datei zu schreiben oder XML zu serialisieren. Sie können auch die Instanz von TextWriter verwenden, um Text in einen benutzerdefinierten Sicherungsspeicher zu schreiben, indem Sie dieselben APIs verwenden, die Sie für eine Zeichenfolge oder einen Datenstrom verwenden würden, oder um Unterstützung für die Textformatierung hinzuzufügen.
Alle Write
Methoden von TextWriter mit primitiven Datentypen als Parameter schreiben die Werte als Zeichenfolgen aus.
Standardmäßig ist ein TextWriter nicht threadsicher. Siehe TextWriter.Synchronized für einen threadsicheren Wrapper.
Wichtig
Dieser Typ implementiert die IDisposable Schnittstelle. Wenn Sie alle Typen verwendet haben, die von diesem Typ abgeleitet sind, 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 "Dispose" und im Abschnitt "Using an Object that Implements IDisposable" im Thema zur IDisposable-Schnittstelle.
Eine Liste allgemeiner E/A-Aufgaben finden Sie unter Allgemeine E/A-Aufgaben.
Hinweise für Ausführende
Eine abgeleitete Klasse muss die Write(Char) Methode minimal implementieren, um eine nützliche Instanz von TextWriterzu machen.
Konstruktoren
TextWriter() |
Initialisiert eine neue Instanz der TextWriter Klasse. |
TextWriter(IFormatProvider) |
Initialisiert eine neue Instanz der TextWriter Klasse mit dem angegebenen Formatanbieter. |
Felder
CoreNewLine |
Speichert die für diese |
Null |
Stellt eine |
Eigenschaften
Encoding |
Wenn eine abgeleitete Klasse überschrieben wird, wird die Zeichencodierung zurückgegeben, in der die Ausgabe geschrieben wird. |
FormatProvider |
Ruft ein Objekt ab, das die Formatierung steuert. |
NewLine |
Dient zum Abrufen oder Festlegen der Zeilenterminatorzeichenfolge, die von der aktuellen |
Methoden
Close() |
Schließt den aktuellen Writer und gibt alle Systemressourcen frei, die dem Writer zugeordnet sind. |
CreateBroadcasting(TextWriter[]) |
Erstellt eine Instanz von TextWriter, die Eingaben für jeden der Autoren in |
CreateObjRef(Type) |
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. |
Dispose(Boolean) |
Gibt die nicht verwalteten Ressourcen frei, die vom TextWriter verwendet werden, und gibt optional die verwalteten Ressourcen frei. |
DisposeAsync() |
Gibt asynchron alle ressourcen frei, die vom TextWriter-Objekt verwendet werden. |
Equals(Object) |
Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object) |
Flush() |
Löscht alle Puffer für den aktuellen Writer und bewirkt, dass alle gepufferten Daten auf das zugrunde liegende Gerät geschrieben werden. |
FlushAsync() |
Löscht asynchron alle Puffer für den aktuellen Writer und bewirkt, dass alle gepufferten Daten auf das zugrunde liegende Gerät geschrieben werden. |
FlushAsync(CancellationToken) |
Löscht asynchron alle Puffer für den aktuellen Writer und bewirkt, dass alle gepufferten Daten auf das zugrunde liegende Gerät geschrieben werden. |
GetHashCode() |
Dient als Standardhashfunktion. (Geerbt von Object) |
GetLifetimeService() |
Veraltet.
Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinie für diese Instanz steuert. (Geerbt von MarshalByRefObject) |
GetType() |
Ruft die Type der aktuellen Instanz ab. (Geerbt von Object) |
InitializeLifetimeService() |
Veraltet.
Ruft ein Lebensdauerdienstobjekt ab, um die Lebensdauerrichtlinie für diese Instanz zu steuern. (Geerbt von MarshalByRefObject) |
MemberwiseClone() |
Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object) |
MemberwiseClone(Boolean) |
Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts. (Geerbt von MarshalByRefObject) |
Synchronized(TextWriter) |
Erstellt einen threadsicheren Wrapper um die angegebene |
ToString() |
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 Textstream. |
Write(Char[]) |
Schreibt ein Zeichenarray in den Textstream. |
Write(Char[], Int32, Int32) |
Schreibt eine Unterarray von Zeichen in den Textstream. |
Write(Decimal) |
Schreibt die Textdarstellung eines Dezimalwerts in den Textstream. |
Write(Double) |
Schreibt die Textdarstellung eines 8-Byte-Gleitkommawerts in den Textstream. |
Write(Int32) |
Schreibt die Textdarstellung einer 4-Byte-Ganzzahl in den Textstream. |
Write(Int64) |
Schreibt die Textdarstellung einer 8-Byte-Ganzzahl in den Textstream. |
Write(Object) |
Schreibt die Textdarstellung eines Objekts in den Textstream, indem die |
Write(ReadOnlySpan<Char>) |
Schreibt einen Zeichenbereich in den Textstream. |
Write(Single) |
Schreibt die Textdarstellung eines 4-Byte-Gleitkommawerts in den Textstream. |
Write(String) |
Schreibt eine Zeichenfolge in den Textstream. |
Write(String, Object) |
Schreibt eine formatierte Zeichenfolge in den Textstream, wobei die gleiche Semantik wie die Format(String, Object)-Methode verwendet wird. |
Write(String, Object, Object) |
Schreibt eine formatierte Zeichenfolge mit derselben Semantik wie die Format(String, Object, Object)-Methode in den Textstream. |
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. |
Write(String, Object[]) |
Schreibt eine formatierte Zeichenfolge in den Textstream, wobei die gleiche Semantik wie die Format(String, Object[])-Methode verwendet wird. |
Write(String, ReadOnlySpan<Object>) |
Schreibt eine formatierte Zeichenfolge in den Textstream, wobei die gleiche Semantik wie Format(String, ReadOnlySpan<Object>)verwendet wird. |
Write(StringBuilder) |
Schreibt einen Zeichenfolgen-Generator in den Textstream. |
Write(UInt32) |
Schreibt die Textdarstellung einer 4-Byte-Ganzzahl ohne Vorzeichen in den Textstream. |
Write(UInt64) |
Schreibt die Textdarstellung einer 8-Byte-Ganzzahl ohne Vorzeichen in den Textstream. |
WriteAsync(Char) |
Schreibt asynchron ein Zeichen in den Textstream. |
WriteAsync(Char[]) |
Schreibt asynchron ein Zeichenarray in den Textstream. |
WriteAsync(Char[], Int32, Int32) |
Schreibt asynchron ein Unterarray von Zeichen in den Textstream. |
WriteAsync(ReadOnlyMemory<Char>, CancellationToken) |
Schreibt asynchron einen Zeichenspeicherbereich in den Textstream. |
WriteAsync(String) |
Schreibt eine Zeichenfolge asynchron in den Textstream. |
WriteAsync(StringBuilder, CancellationToken) |
Schreibt asynchron einen Zeichenfolgen-Generator in den Textstream. |
WriteLine() |
Schreibt einen Zeilenendpunkt in den Textstream. |
WriteLine(Boolean) |
Schreibt die Textdarstellung eines |
WriteLine(Char) |
Schreibt ein Zeichen in den Textstream, gefolgt von einem Zeilenterminator. |
WriteLine(Char[]) |
Schreibt ein Array von Zeichen in den Textstream, gefolgt von einem Zeilenterminator. |
WriteLine(Char[], Int32, Int32) |
Schreibt eine Unterarray von Zeichen in den Textstream, gefolgt von einem Zeilenterminator. |
WriteLine(Decimal) |
Schreibt die Textdarstellung eines Dezimalwerts in den Textstream, gefolgt von einem Zeilenterminator. |
WriteLine(Double) |
Schreibt die Textdarstellung eines 8-Byte-Gleitkommawerts in den Textstream, gefolgt von einem Zeilenterminator. |
WriteLine(Int32) |
Schreibt die Textdarstellung einer 4-Byte-Ganzzahl in den Textstream, gefolgt von einem Zeilenterminator. |
WriteLine(Int64) |
Schreibt die Textdarstellung einer 8-Byte-Ganzzahl in den Textstream, gefolgt von einem Zeilenterminator. |
WriteLine(Object) |
Schreibt die Textdarstellung eines Objekts in den Textstream, indem die |
WriteLine(ReadOnlySpan<Char>) |
Schreibt die Textdarstellung eines Zeichenbereichs in den Textstream, gefolgt von einem Zeilenterminator. |
WriteLine(Single) |
Schreibt die Textdarstellung eines 4-Byte-Gleitkommawerts in den Textstream, gefolgt von einem Zeilenterminator. |
WriteLine(String) |
Schreibt eine Zeichenfolge in den Textstream, gefolgt von einem Zeilenterminator. |
WriteLine(String, Object) |
Schreibt eine formatierte Zeichenfolge und eine neue Zeile in den Textstream, wobei die gleiche Semantik wie die Format(String, Object)-Methode verwendet wird. |
WriteLine(String, Object, Object) |
Schreibt eine formatierte Zeichenfolge und eine neue Zeile in den Textstream, wobei die gleiche Semantik wie die Format(String, Object, Object)-Methode verwendet wird. |
WriteLine(String, Object, Object, Object) |
Schreibt eine formatierte Zeichenfolge und eine neue Zeile in den Textstream, wobei die gleiche Semantik wie Format(String, Object)verwendet wird. |
WriteLine(String, Object[]) |
Schreibt eine formatierte Zeichenfolge und eine neue Zeile in den Textstream, wobei die gleiche Semantik wie Format(String, Object)verwendet wird. |
WriteLine(String, ReadOnlySpan<Object>) |
Schreibt eine formatierte Zeichenfolge und eine neue Zeile in den Textstream, wobei die gleiche Semantik wie Format(String, ReadOnlySpan<Object>)verwendet wird. |
WriteLine(StringBuilder) |
Schreibt die Textdarstellung eines Zeichenfolgen-Generators in den Textstream, gefolgt von einem Zeilenterminator. |
WriteLine(UInt32) |
Schreibt die Textdarstellung einer 4-Byte-Ganzzahl ohne Vorzeichen in den Textstream, gefolgt von einem Zeilenterminator. |
WriteLine(UInt64) |
Schreibt die Textdarstellung einer 8-Byte-Ganzzahl ohne Vorzeichen in den Textstream, gefolgt von einem Zeilenterminator. |
WriteLineAsync() |
Schreibt asynchron einen Zeilenterminator in den Textstream. |
WriteLineAsync(Char) |
Schreibt asynchron ein Zeichen in den Textstream, gefolgt von einem Zeilenterminator. |
WriteLineAsync(Char[]) |
Schreibt asynchron ein Array von Zeichen in den Textstream, gefolgt von einem Zeilenterminator. |
WriteLineAsync(Char[], Int32, Int32) |
Schreibt asynchron eine Unterarray von Zeichen in den Textstream, gefolgt von einem Zeilenterminator. |
WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken) |
Schreibt asynchron die Textdarstellung eines Zeichenspeicherbereichs in den Textstream, gefolgt von einem Zeilenterminator. |
WriteLineAsync(String) |
Schreibt asynchron eine Zeichenfolge in den Textstream, gefolgt von einem Zeilenterminator. |
WriteLineAsync(StringBuilder, CancellationToken) |
Schreibt asynchron die Textdarstellung eines Zeichenfolgen-Generators in den Textstream, gefolgt von einem Zeilenterminator. |
Explizite Schnittstellenimplementierungen
IDisposable.Dispose() |
Eine Beschreibung dieses Mitglieds finden Sie unter Dispose(). |
Erweiterungsmethoden
ConfigureAwait(IAsyncDisposable, Boolean) |
Konfiguriert, wie auf die von einem asynchronen Einweg zurückgegebenen Aufgaben gewartet wird. |
Gilt für:
Weitere Informationen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Tickets als Feedbackmechanismus für Inhalte auslaufen lassen und es durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter:Einreichen und Feedback anzeigen für