TextWriter Klasse

Definition

Stellt einen Writer dar, der eine sequenzielle Serie 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 im Code. Die StreamWriter -Klasse leitet sich von ab TextWriter und stellt Implementierungen der Member zum Schreiben in einen Stream bereit. Im folgenden Beispiel wird gezeigt, wie zwei Zeilen, die aus Zeichenfolgenwerten bestehen, mithilfe der WriteLineAsync(String) -Methode in eine Textdatei geschrieben werden.

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 Streams bzw. Zeichenfolgen schreiben. Verwenden Sie eine instance vonTextWriter, um ein Objekt in eine Zeichenfolge zu schreiben, Zeichenfolgen in eine Datei zu schreiben oder XML zu serialisieren. Sie können auch die instance von TextWriter verwenden, um Text in einen benutzerdefinierten Sicherungsspeicher mit den gleichen APIs zu schreiben, die Sie für eine Zeichenfolge oder einen Stream verwenden würden, oder um Unterstützung für die Textformatierung hinzuzufügen.

Alle Methoden, TextWriter mit denen Write primitive Datentypen als Parameter verwendet werden, schreiben die Werte als Zeichenfolgen aus.

Standardmäßig ist ein TextWriter nicht threadsicher. Einen threadsicheren Wrapper finden Sie unter TextWriter.Synchronized .

Wichtig

Dieser Typ implementiert die IDisposable-Schnittstelle. Wenn Sie mit der Verwendung eines typs abgeschlossen haben, der von diesem Typ abgeleitet ist, sollten Sie ihn entweder direkt oder indirekt entsorgen. Zum direkten Löschen des Typs rufen Sie seine Dispose-Methode in einem try/catch-Block auf. Zum indirekten Löschen verwenden Sie ein Sprachkonstrukt wie using (in C#) oder Using (in Visual Basic). Weitere Informationen finden Sie unter Dispose und im Abschnitt "Using an Object that Implements IDisposable" (Verwenden eines Objekts, das IDisposable implementiert) im IDisposable Schnittstellenthema.

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 instance von TextWriterzu erstellen.

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 diesen TextWriter verwendeten Zeilenendemarken.

Null

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

Eigenschaften

Encoding

Gibt beim Überschreiben in einer abgeleiteten Klasse die Zeichencodierung zurück, in der die Ausgabe geschrieben ist.

FormatProvider

Ruft ein Objekt zum Steuern der Formatierung ab.

NewLine

Ruft die Zeichenfolge für den Zeilenabschluss ab, die vom aktuellen TextWriter verwendet wird, oder legt diese fest.

Methoden

Close()

Schließt den aktuellen Writer und gibt alle dem Writer zugeordneten Systemressourcen frei.

CreateBroadcasting(TextWriter[])

Stellt einen Writer dar, der eine sequenzielle Serie von Zeichen schreiben kann. Diese Klasse ist abstrakt.

CreateObjRef(Type)

Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind.

(Geerbt von MarshalByRefObject)
Dispose()

Gibt alle vom TextWriter-Objekt verwendeten Ressourcen frei.

Dispose(Boolean)

Gibt die von TextWriter verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei.

DisposeAsync()

Gibt alle vom TextWriter-Objekt verwendeten Ressourcen asynchron frei.

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
Flush()

Löscht sämtliche Puffer für den aktuellen Writer und veranlasst die Ausgabe aller gepufferten Daten an das zugrunde liegende Gerät.

FlushAsync()

Löscht sämtliche Puffer für den aktuellen Writer asynchron und veranlasst die Ausgabe aller gepufferten Daten an das zugrunde liegende Gerät.

FlushAsync(CancellationToken)

Löscht sämtliche Puffer für den aktuellen Writer asynchron und veranlasst die Ausgabe aller gepufferten Daten an das zugrunde liegende Gerät.

GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetLifetimeService()
Veraltet.

Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert.

(Geerbt von MarshalByRefObject)
GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
InitializeLifetimeService()
Veraltet.

Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab.

(Geerbt von MarshalByRefObject)
MemberwiseClone()

Erstellt eine flache Kopie des 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 den angegebenen TextWriter.

ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)
Write(Boolean)

Schreibt die Textdarstellung eines Boolean-Werts in den Textstream.

Write(Char)

Schreibt ein Zeichen in den Textstream.

Write(Char[])

Schreibt ein Zeichenarray in den Textstream.

Write(Char[], Int32, Int32)

Schreibt ein Teilarray 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 mit Vorzeichen in den Textstream.

Write(Int64)

Schreibt die Textdarstellung einer 8-Byte-Ganzzahl mit Vorzeichen in den Textstream.

Write(Object)

Schreibt die Textdarstellung eines Objekts in den Textstream, indem für das Objekt die ToString-Methode aufgerufen wird.

Write(ReadOnlySpan<Char>)

Schreibt eine Zeichenspanne 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 unter Verwendung der gleichen Semantik wie die Format(String, Object)-Methode.

Write(String, Object, Object)

Schreibt eine formatierte Zeichenfolge in den Textstream unter Verwendung der gleichen Semantik wie die Format(String, Object, Object)-Methode.

Write(String, Object, Object, Object)

Schreibt eine formatierte Zeichenfolge in den Textstream unter Verwendung der gleichen Semantik wie die Format(String, Object, Object, Object)-Methode.

Write(String, Object[])

Schreibt eine formatierte Zeichenfolge in den Textstream unter Verwendung der gleichen Semantik wie die Format(String, Object[])-Methode.

Write(StringBuilder)

Schreibt einen Zeichenfolgengenerator 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 ein Zeichen asynchron in den Textstream.

WriteAsync(Char[])

Schreibt ein Zeichenarray asynchron in den Textstream.

WriteAsync(Char[], Int32, Int32)

Schreibt ein Teilarray von Zeichen asynchron in den Textstream.

WriteAsync(ReadOnlyMemory<Char>, CancellationToken)

Schreibt eine Zeichenspeicherregion asynchron in den Textstream.

WriteAsync(String)

Schreibt eine Zeichenfolge asynchron in den Textstream.

WriteAsync(StringBuilder, CancellationToken)

Schreibt einen Zeichenfolgengenerator asynchron in den Textstream.

WriteLine()

Schreibt ein Zeichen für den Zeilenabschluss in den Textstream.

WriteLine(Boolean)

Schreibt die Textdarstellung eines Boolean-Werts, auf die ein Zeichen für den Zeilenabschluss folgt, in den Textstream.

WriteLine(Char)

Schreibt ein Zeichen, auf das ein Zeichen für den Zeilenabschluss folgt, in den Textstream.

WriteLine(Char[])

Schreibt ein Array von Zeichen, gefolgt von einem Zeichen für den Zeilenabschluss, in den Textstream.

WriteLine(Char[], Int32, Int32)

Schreibt ein Unterarray von Zeichen, auf das ein Zeichen für den Zeilenabschluss folgt, in den Textstream.

WriteLine(Decimal)

Schreibt die Textdarstellung eines Dezimalwerts, auf die ein Zeichen für den Zeilenabschluss folgt, in den Textstream.

WriteLine(Double)

Schreibt die Textdarstellung eines 8-Byte-Gleitkommawerts, gefolgt von einem Zeichen für den Zeilenabschluss, in den Textstream.

WriteLine(Int32)

Schreibt die Textdarstellung einer 4-Byte-Ganzzahl mit Vorzeichen, gefolgt von einem Zeichen für den Zeilenabschluss, in den Textstream.

WriteLine(Int64)

Schreibt die Textdarstellung einer 8-Byte-Ganzzahl mit Vorzeichen, gefolgt von einem Zeichen für den Zeilenabschluss, in den Textstream.

WriteLine(Object)

Schreibt durch Aufrufen der ToString-Methode für ein Objekt die Textdarstellung dieses Objekts, gefolgt von einem Zeichen für den Zeilenabschluss, in den Textstream.

WriteLine(ReadOnlySpan<Char>)

Schreibt die Textdarstellung einer Zeichenspanne, auf die ein Zeichen für den Zeilenabschluss folgt, in den Textstream.

WriteLine(Single)

Schreibt die Textdarstellung eines 4-Byte-Gleitkommawerts, gefolgt von einem Zeichen für den Zeilenabschluss, in den Textstream.

WriteLine(String)

Schreibt eine Zeichenfolge, gefolgt von einem Zeichen für den Zeilenabschluss, in den Textstream.

WriteLine(String, Object)

Schreibt eine formatierte Zeichenfolge und eine neue Zeile in den Textstream unter Verwendung der gleichen Semantik wie die Format(String, Object)-Methode.

WriteLine(String, Object, Object)

Schreibt eine formatierte Zeichenfolge und eine neue Zeile in den Textstream unter Verwendung der gleichen Semantik wie die Format(String, Object, Object)-Methode.

WriteLine(String, Object, Object, Object)

Schreibt eine formatierte Zeichenfolge und eine neue Zeile in den Textstream unter Verwendung der gleichen Semantik wie Format(String, Object).

WriteLine(String, Object[])

Schreibt eine formatierte Zeichenfolge und eine neue Zeile in den Textstream unter Verwendung der gleichen Semantik wie Format(String, Object).

WriteLine(StringBuilder)

Schreibt die Textdarstellung eines Zeichenfolgengenerators, auf die ein Zeichen für den Zeilenabschluss folgt, in den Textstream.

WriteLine(UInt32)

Schreibt die Textdarstellung einer 4-Byte-Ganzzahl ohne Vorzeichen, gefolgt von einem Zeichen für den Zeilenabschluss, in den Textstream.

WriteLine(UInt64)

Schreibt die Textdarstellung einer 8-Byte-Ganzzahl ohne Vorzeichen, gefolgt von einem Zeichen für den Zeilenabschluss, in den Textstream.

WriteLineAsync()

Schreibt ein Zeichen für den Zeilenabschluss asynchron in den Textstream.

WriteLineAsync(Char)

Schreibt ein Zeichen, auf das ein Zeichen für den Zeilenabschluss folgt, asynchron in den Textstream.

WriteLineAsync(Char[])

Schreibt ein Array von Zeichen, gefolgt von einem Zeichen für den Zeilenabschluss, asynchron in den Textstream.

WriteLineAsync(Char[], Int32, Int32)

Schreibt ein Unterarray von Zeichen, gefolgt von einem Zeichen für den Zeilenabschluss, asynchron in den Textstream.

WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)

Schreibt die Textdarstellung einer Zeichenspeicherregion, auf die ein Zeichen für den Zeilenabschluss folgt, asynchron in den Textstream.

WriteLineAsync(String)

Schreibt eine Zeichenfolge, gefolgt von einem Zeichen für den Zeilenabschluss, asynchron in den Textstream.

WriteLineAsync(StringBuilder, CancellationToken)

Schreibt die Textdarstellung eines Zeichenfolgengenerators, auf die ein Zeichen für den Zeilenabschluss folgt, asynchron in den Textstream.

Explizite Schnittstellenimplementierungen

IDisposable.Dispose()

Eine Beschreibung dieses Elements finden Sie unter Dispose().

Erweiterungsmethoden

ConfigureAwait(IAsyncDisposable, Boolean)

Konfiguriert, wie Wartezeiten auf die Aufgaben angewandt werden, die von einem asynchronen verwerfbaren Element zurückgegeben werden.

Gilt für:

Weitere Informationen