TextWriter Klas

Definitie

Naamruimte:
System.IO
Assembly's:
mscorlib.dll, System.IO.dll
Assembly:
mscorlib.dll
Assembly:
System.IO.dll
Assembly:
netstandard.dll

Vertegenwoordigt een schrijver die een sequentiële reeks tekens kan schrijven. Deze klasse is abstract.

public ref class TextWriter abstract : IDisposable
public ref class TextWriter abstract : MarshalByRefObject, IDisposable
public ref class TextWriter abstract : MarshalByRefObject, IAsyncDisposable, IDisposable
public abstract class TextWriter : IDisposable
[System.Serializable]
public abstract class TextWriter : MarshalByRefObject, IDisposable
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public abstract class TextWriter : MarshalByRefObject, IDisposable
public abstract class TextWriter : MarshalByRefObject, IDisposable
public abstract class TextWriter : MarshalByRefObject, IAsyncDisposable, IDisposable
type TextWriter = class
    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
type TextWriter = class
    inherit MarshalByRefObject
    interface IDisposable
type TextWriter = class
    inherit MarshalByRefObject
    interface IAsyncDisposable
    interface IDisposable
Public MustInherit Class TextWriter
Implements IDisposable
Public MustInherit Class TextWriter
Inherits MarshalByRefObject
Implements IDisposable
Public MustInherit Class TextWriter
Inherits MarshalByRefObject
Implements IAsyncDisposable, IDisposable
Overname
Object
TextWriter
Overname
Object
MarshalByRefObject
TextWriter
Afgeleid
Kenmerken
SerializableAttribute ComVisibleAttribute
Implementeringen
IDisposable IAsyncDisposable

Voorbeelden

De TextWriter klasse is een abstracte klasse. Daarom maakt u deze niet instantiëren in uw code. De StreamWriter klasse is afgeleid van TextWriter en biedt implementaties van de leden voor het schrijven naar een stream. In het volgende voorbeeld ziet u hoe u twee regels schrijft die bestaan uit tekenreekswaarden naar een tekstbestand met behulp van de WriteLineAsync(String) methode.

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

Opmerkingen

TextWriter is de abstracte basisklasse van StreamWriter en StringWriter, die respectievelijk tekens naar streams en tekenreeksen schrijft. Gebruik een exemplaar van het schrijven van een object naar een tekenreeks, het schrijven van tekenreeksen naar een bestand of het serialiseren van TextWriter XML. U kunt ook het exemplaar van het schrijven van TextWriter tekst naar een aangepaste back-upopslag gebruiken met dezelfde API's die u zou gebruiken voor een tekenreeks of een stroom, of om ondersteuning voor tekstopmaak toe te voegen.

Alle methoden voor het Write hebben van TextWriter primitieve gegevenstypen als parameters schrijven de waarden uit als tekenreeksen.

Standaard is een TextWriter niet thread veilig. Zie TextWriter.Synchronized voor een thread-safe wrapper.

Important

Met dit type wordt de IDisposable interface geïmplementeerd. Wanneer u klaar bent met het gebruik van een type dat is afgeleid van dit type, moet u het rechtstreeks of indirect verwijderen. Als u het type rechtstreeks wilt verwijderen, roept u de Dispose methode aan in een try/catch blok. Als u deze indirect wilt verwijderen, gebruikt u een taalconstructie zoals using (in C#) of Using (in Visual Basic). Zie Verwijderen en de sectie 'Een object gebruiken dat IDisposable implementeert' in het IDisposable interfaceonderwerp voor meer informatie.

Zie Algemene I/O-taken voor een lijst met algemene I/O-taken.

Notities voor uitvoerders

Een afgeleide klasse moet de Write(Char) methode minimaal implementeren om een nuttig exemplaar van TextWriter.

Constructors

Name Description
TextWriter()

Initialiseert een nieuw exemplaar van de TextWriter klasse.
TextWriter(IFormatProvider)

Initialiseert een nieuw exemplaar van de TextWriter klasse met de opgegeven indelingsprovider.

Velden

Name Description
CoreNewLine

Slaat de nieuwe regeltekens op die hiervoor TextWriterworden gebruikt.
Null

Biedt een TextWriter archief zonder back-up waarnaar kan worden geschreven, maar niet gelezen van.

Eigenschappen

Name Description
Encoding

Wanneer deze wordt overschreven in een afgeleide klasse, wordt de tekencodering geretourneerd waarin de uitvoer wordt geschreven.
FormatProvider

Hiermee haalt u een object op waarmee de opmaak wordt beheerd.
NewLine

Hiermee haalt u de regeleindtekenreeks op die door de huidige TextWriterwordt gebruikt of stelt u deze in.

Methoden

Name Description
Close()

Sluit de huidige schrijver en publiceert alle systeemresources die aan de schrijver zijn gekoppeld.
CreateObjRef(Type)

Hiermee maakt u een object dat alle relevante informatie bevat die nodig is om een proxy te genereren die wordt gebruikt om te communiceren met een extern object.

(Overgenomen van MarshalByRefObject)
Dispose()

Alle resources die door het TextWriter object worden gebruikt, worden vrijgegeven.
Dispose(Boolean)

Publiceert de niet-beheerde resources die worden gebruikt door de TextWriter beheerde resources en brengt eventueel de beheerde resources vrij.
DisposeAsync()

Asynchroon geeft alle resources vrij die door het TextWriter object worden gebruikt.
Equals(Object)

Bepaalt of het opgegeven object gelijk is aan het huidige object.

(Overgenomen van Object)
Flush()

Wist alle buffers voor de huidige schrijver en zorgt ervoor dat gebufferde gegevens naar het onderliggende apparaat worden geschreven.
FlushAsync()

Asynchroon wist alle buffers voor de huidige schrijver en zorgt ervoor dat eventuele gebufferde gegevens naar het onderliggende apparaat worden geschreven.
GetHashCode()

Fungeert als de standaardhashfunctie.

(Overgenomen van Object)
GetLifetimeService()

Hiermee haalt u het huidige levensduurserviceobject op waarmee het levensduurbeleid voor dit exemplaar wordt beheerd.

(Overgenomen van MarshalByRefObject)
GetType()

Hiermee haalt u de Type huidige instantie op.

(Overgenomen van Object)
InitializeLifetimeService()

Hiermee haalt u een levensduurserviceobject op om het levensduurbeleid voor dit exemplaar te beheren.

(Overgenomen van MarshalByRefObject)
MemberwiseClone()

Hiermee maakt u een ondiepe kopie van de huidige Object.

(Overgenomen van Object)
MemberwiseClone(Boolean)

Hiermee maakt u een ondiepe kopie van het huidige MarshalByRefObject object.

(Overgenomen van MarshalByRefObject)
Synchronized(TextWriter)

Hiermee maakt u een thread-veilige wrapper rond de opgegeven TextWriter.
ToString()

Retourneert een tekenreeks die het huidige object vertegenwoordigt.

(Overgenomen van Object)
Write(Boolean)

Hiermee schrijft u de tekstweergave van een Boolean waarde naar de tekststroom.
Write(Char)

Hiermee schrijft u een teken naar de tekststroom.
Write(Char[], Int32, Int32)

Hiermee schrijft u een submaarray van tekens naar de tekststroom.
Write(Char[])

Hiermee schrijft u een tekenmatrix naar de tekststroom.
Write(Decimal)

Hiermee schrijft u de tekstweergave van een decimale waarde naar de tekststroom.
Write(Double)

Hiermee schrijft u de tekstweergave van een 8-byte zwevende-kommawaarde naar de tekststroom.
Write(Int32)

Hiermee schrijft u de tekstweergave van een geheel getal met 4 bytetekens naar de tekststroom.
Write(Int64)

Hiermee schrijft u de tekstweergave van een geheel getal van 8 byte dat is ondertekend naar de tekststroom.
Write(Object)

Hiermee schrijft u de tekstweergave van een object naar de tekststroom door de ToString methode voor dat object aan te roepen.
Write(ReadOnlySpan<Char>)

Hiermee schrijft u een tekenbereik naar de tekststroom.
Write(Single)

Hiermee schrijft u de tekstweergave van een 4-byte zwevende-kommawaarde naar de tekststroom.
Write(String, Object, Object, Object)

Hiermee schrijft u een opgemaakte tekenreeks naar de tekststroom, met behulp van dezelfde semantiek als de Format(String, Object, Object, Object) methode.
Write(String, Object, Object)

Hiermee schrijft u een opgemaakte tekenreeks naar de tekststroom met behulp van dezelfde semantiek als de Format(String, Object, Object) methode.
Write(String, Object)

Hiermee schrijft u een opgemaakte tekenreeks naar de tekststroom, met behulp van dezelfde semantiek als de Format(String, Object) methode.
Write(String, Object[])

Hiermee schrijft u een opgemaakte tekenreeks naar de tekststroom, met behulp van dezelfde semantiek als de Format(String, Object[]) methode.
Write(String)

Hiermee schrijft u een tekenreeks naar de tekststroom.
Write(UInt32)

Hiermee schrijft u de tekstweergave van een niet-ondertekend geheel getal van vier bytes naar de tekststroom.
Write(UInt64)

Hiermee schrijft u de tekstweergave van een niet-ondertekend geheel getal van 8 bytes naar de tekststroom.
WriteAsync(Char)

Hiermee schrijft u een teken asynchroon naar de tekststroom.
WriteAsync(Char[], Int32, Int32)

Hiermee schrijft u een submaarray van tekens naar de tekststroom asynchroon.
WriteAsync(Char[])

Hiermee schrijft u een tekenmatrix asynchroon naar de tekststroom.
WriteAsync(ReadOnlyMemory<Char>, CancellationToken)

Asynchroon schrijft een tekengeheugengebied naar de tekststroom.
WriteAsync(String)

Hiermee schrijft u een tekenreeks asynchroon naar de tekststroom.
WriteLine()

Hiermee schrijft u een regeleindteken naar de tekststroom.
WriteLine(Boolean)

Hiermee schrijft u de tekstweergave van een Boolean waarde naar de tekststroom, gevolgd door een regeleindteken.
WriteLine(Char)

Hiermee schrijft u een teken naar de tekststroom, gevolgd door een regeleindteken.
WriteLine(Char[], Int32, Int32)

Hiermee schrijft u een submaarray van tekens naar de tekststroom, gevolgd door een regeleindteken.
WriteLine(Char[])

Hiermee schrijft u een matrix met tekens naar de tekststroom, gevolgd door een regeleindteken.
WriteLine(Decimal)

Hiermee schrijft u de tekstweergave van een decimale waarde naar de tekststroom, gevolgd door een regeleindteken.
WriteLine(Double)

Hiermee schrijft u de tekstweergave van een 8-byte zwevende-kommawaarde naar de tekststroom, gevolgd door een regeleindteken.
WriteLine(Int32)

Hiermee schrijft u de tekstweergave van een geheel getal met 4 bytetekens naar de tekststroom, gevolgd door een regeleindteken.
WriteLine(Int64)

Hiermee schrijft u de tekstweergave van een geheel getal met 8 bytetekens naar de tekststroom, gevolgd door een regeleindteken.
WriteLine(Object)

Hiermee schrijft u de tekstweergave van een object naar de tekststroom door de ToString methode voor dat object aan te roepen, gevolgd door een regeleindteken.
WriteLine(ReadOnlySpan<Char>)

Hiermee schrijft u de tekstweergave van een tekenstroom naar de tekststroom, gevolgd door een regeleindteken.
WriteLine(Single)

Hiermee schrijft u de tekstweergave van een 4-byte zwevende-kommawaarde naar de tekststroom, gevolgd door een regeleindteken.
WriteLine(String, Object, Object, Object)

Hiermee schrijft u een opgemaakte tekenreeks en een nieuwe regel naar de tekststroom, met behulp van dezelfde semantiek als Format(String, Object).
WriteLine(String, Object, Object)

Hiermee schrijft u een opgemaakte tekenreeks en een nieuwe regel naar de tekststroom, met behulp van dezelfde semantiek als de Format(String, Object, Object) methode.
WriteLine(String, Object)

Hiermee schrijft u een opgemaakte tekenreeks en een nieuwe regel naar de tekststroom, met behulp van dezelfde semantiek als de Format(String, Object) methode.
WriteLine(String, Object[])

Hiermee schrijft u een opgemaakte tekenreeks en een nieuwe regel naar de tekststroom, met behulp van dezelfde semantiek als Format(String, Object).
WriteLine(String)

Hiermee schrijft u een tekenreeks naar de tekststroom, gevolgd door een regeleindteken.
WriteLine(UInt32)

Hiermee schrijft u de tekstweergave van een niet-ondertekend geheel getal van vier bytes naar de tekststroom, gevolgd door een regeleindteken.
WriteLine(UInt64)

Hiermee schrijft u de tekstweergave van een niet-ondertekend geheel getal van 8 bytes naar de tekststroom, gevolgd door een regeleindteken.
WriteLineAsync()

Asynchroon schrijft een regeleindteken naar de tekststroom.
WriteLineAsync(Char)

Asynchroon schrijft een teken naar de tekststroom, gevolgd door een regeleindteken.
WriteLineAsync(Char[], Int32, Int32)

Asynchroon schrijft een submaarray van tekens naar de tekststroom, gevolgd door een regeleindteken.
WriteLineAsync(Char[])

Asynchroon schrijft een matrix met tekens naar de tekststroom, gevolgd door een regeleindteken.
WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)

Asynchroon schrijft de tekstweergave van een tekengeheugengebied naar de tekststroom, gevolgd door een regeleindteken.
WriteLineAsync(String)

Asynchroon schrijft een tekenreeks naar de tekststroom, gevolgd door een regeleindteken.

Expliciete interface-implementaties

Name Description
IDisposable.Dispose()

Zie voor een beschrijving van dit lid Dispose().

Extensiemethoden

Name Description
ConfigureAwait(IAsyncDisposable, Boolean)

Hiermee configureert u hoe wacht op de taken die worden geretourneerd op basis van een asynchroon wegwerp, worden uitgevoerd.

Van toepassing op

Zie ook