TextWriter Klass

Definition

Namnområde:: System.IO

Sammansättningar:: mscorlib.dll, System.IO.dll

Sammansättning:: mscorlib.dll

Sammansättning:: System.IO.dll

Sammansättning:: netstandard.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Representerar en skrivare som kan skriva en sekventiell serie tecken. Den här klassen är abstrakt.

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

Arv: Object
TextWriter

Arv: Object

MarshalByRefObject
TextWriter

Härledda: System.CodeDom.Compiler.IndentedTextWriter

System.IO.StreamWriter

System.IO.StringWriter

System.Web.HttpWriter

System.Web.UI.HtmlTextWriter

Attribut: SerializableAttribute ComVisibleAttribute

Implementeringar: IDisposable IAsyncDisposable

Exempel

Klassen TextWriter är en abstrakt klass. Därför instansierar du den inte i koden. Klassen StreamWriter härleds från TextWriter och tillhandahåller implementeringar av medlemmarna för att skriva till en dataström. I följande exempel visas hur du skriver två rader som består av strängvärden till en textfil med hjälp WriteLineAsync(String) av metoden .

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

Kommentarer

TextWriter är den abstrakta basklassen för StreamWriter och StringWriter, som skriver tecken till strömmar respektive strängar. Använd en instans av TextWriter för att skriva ett objekt till en sträng, skriva strängar till en fil eller serialisera XML. Du kan också använda instansen av TextWriter för att skriva text till ett anpassat lagringsarkiv med samma API:er som du skulle använda för en sträng eller en ström, eller för att lägga till stöd för textformatering.

Write Alla metoder TextWriter för att ha primitiva datatyper som parametrar skriver ut värdena som strängar.

Som standard är en TextWriter inte trådsäker. Se TextWriter.Synchronized för en trådsäker omslutning.

Important

Den här typen implementerar IDisposable gränssnittet. När du har använt någon typ som härleds från den här typen bör du ta bort den antingen direkt eller indirekt. Om du vill ta bort typen direkt anropar du dess Dispose metod i ett try/catch block. Om du vill ta bort det indirekt använder du en språkkonstruktion som using (i C#) eller Using (i Visual Basic). Mer information finns i Ta bort och avsnittet "Använda ett objekt som implementerar IDisposable" i IDisposable gränssnittet.

En lista över vanliga I/O-uppgifter finns i Vanliga I/O-uppgifter.

Anteckningar till implementerare

En härledd klass måste implementera metoden minimalt Write(Char) för att göra en användbar instans av TextWriter.

Konstruktorer

Name	Description
TextWriter()	Initierar en ny instans av TextWriter klassen.
TextWriter(IFormatProvider)	Initierar en ny instans av TextWriter klassen med den angivna formatprovidern.

Fält

Name	Description
CoreNewLine	Lagrar de nya radtecken som används för den här `TextWriter`.
Null	Tillhandahåller ett `TextWriter` utan stödarkiv som kan skrivas till, men inte läsas från.

Egenskaper

Name	Description
Encoding	När den åsidosättas i en härledd klass returnerar den teckenkodning där utdata skrivs.
FormatProvider	Hämtar ett objekt som styr formateringen.
NewLine	Hämtar eller anger radavslutarsträngen som används av den aktuella `TextWriter`.

Metoder

Name	Description
Close()	Stänger den aktuella skrivaren och släpper alla systemresurser som är associerade med skrivaren.
CreateObjRef(Type)	Skapar ett objekt som innehåller all relevant information som krävs för att generera en proxy som används för att kommunicera med ett fjärrobjekt. (Ärvd från MarshalByRefObject)
Dispose()	Frigör alla resurser som används av TextWriter objektet.
Dispose(Boolean)	Släpper de ohanterade resurser som används av TextWriter och släpper eventuellt de hanterade resurserna.
DisposeAsync()	Asynkront frigör alla resurser som används av TextWriter objektet.
Equals(Object)	Avgör om det angivna objektet är lika med det aktuella objektet. (Ärvd från Object)
Flush()	Rensar alla buffertar för den aktuella skrivaren och gör att buffrade data skrivs till den underliggande enheten.
FlushAsync()	Rensar asynkront alla buffertar för den aktuella skrivaren och gör att buffrade data skrivs till den underliggande enheten.
GetHashCode()	Fungerar som standard-hash-funktion. (Ärvd från Object)
GetLifetimeService()	Hämtar det aktuella livslängdstjänstobjektet som styr livslängdsprincipen för den här instansen. (Ärvd från MarshalByRefObject)
GetType()	Hämtar den aktuella instansen Type . (Ärvd från Object)
InitializeLifetimeService()	Hämtar ett tjänstobjekt för livslängd för att styra livslängdsprincipen för den här instansen. (Ärvd från MarshalByRefObject)
MemberwiseClone()	Skapar en ytlig kopia av den aktuella Object. (Ärvd från Object)
MemberwiseClone(Boolean)	Skapar en ytlig kopia av det aktuella MarshalByRefObject objektet. (Ärvd från MarshalByRefObject)
Synchronized(TextWriter)	Skapar en trådsäker omslutning runt den angivna `TextWriter`.
ToString()	Returnerar en sträng som representerar det aktuella objektet. (Ärvd från Object)
Write(Boolean)	Skriver textrepresentationen av ett `Boolean` värde till textströmmen.
Write(Char)	Skriver ett tecken till textströmmen.
Write(Char[], Int32, Int32)	Skriver ett underordnat tecken till textströmmen.
Write(Char[])	Skriver en teckenmatris till textströmmen.
Write(Decimal)	Skriver textrepresentationen av ett decimalvärde till textströmmen.
Write(Double)	Skriver textrepresentationen av ett flyttalsvärde på 8 byte till textströmmen.
Write(Int32)	Skriver textrepresentationen av ett 4 byte signerat heltal till textströmmen.
Write(Int64)	Skriver textrepresentationen av ett 8 byte signerat heltal till textströmmen.
Write(Object)	Skriver textrepresentationen av ett objekt till textströmmen genom att anropa `ToString` metoden för objektet.
Write(ReadOnlySpan<Char>)	Skriver ett teckenintervall till textströmmen.
Write(Single)	Skriver textrepresentationen av ett flyttalsvärde på 4 byte till textströmmen.
Write(String, Object, Object, Object)	Skriver en formaterad sträng till textströmmen med samma semantik som Format(String, Object, Object, Object) metoden.
Write(String, Object, Object)	Skriver en formaterad sträng till textströmmen med samma semantik som Format(String, Object, Object) metoden.
Write(String, Object)	Skriver en formaterad sträng till textströmmen med samma semantik som Format(String, Object) metoden.
Write(String, Object[])	Skriver en formaterad sträng till textströmmen med samma semantik som Format(String, Object[]) metoden.
Write(String)	Skriver en sträng till textströmmen.
Write(UInt32)	Skriver textrepresentationen av ett osignerat heltal på 4 byte till textströmmen.
Write(UInt64)	Skriver textrepresentationen av ett osignerat heltal på 8 byte till textströmmen.
WriteAsync(Char)	Skriver ett tecken till textströmmen asynkront.
WriteAsync(Char[], Int32, Int32)	Skriver ett underordnat tecken till textströmmen asynkront.
WriteAsync(Char[])	Skriver en teckenmatris till textströmmen asynkront.
WriteAsync(ReadOnlyMemory<Char>, CancellationToken)	Skriver asynkront en teckenminnesregion till textströmmen.
WriteAsync(String)	Skriver en sträng till textströmmen asynkront.
WriteLine()	Skriver en radavgränsare till textströmmen.
WriteLine(Boolean)	Skriver textrepresentationen av ett `Boolean` värde till textströmmen följt av en radavgränsare.
WriteLine(Char)	Skriver ett tecken till textströmmen följt av en radavgränsare.
WriteLine(Char[], Int32, Int32)	Skriver ett underordnat tecken till textströmmen följt av en radavgränsare.
WriteLine(Char[])	Skriver en matris med tecken till textströmmen följt av en radavgränsare.
WriteLine(Decimal)	Skriver textrepresentationen av ett decimalvärde till textströmmen följt av en radavgränsare.
WriteLine(Double)	Skriver textrepresentationen av ett flyttal på 8 byte till textströmmen följt av en radavgränsare.
WriteLine(Int32)	Skriver textrepresentationen av ett 4 byte signerat heltal till textströmmen, följt av en radavgränsare.
WriteLine(Int64)	Skriver textrepresentationen av ett 8 byte signerat heltal till textströmmen, följt av en radavgränsare.
WriteLine(Object)	Skriver textrepresentationen av ett objekt till textströmmen genom att anropa `ToString` metoden för objektet, följt av en radavgränsare.
WriteLine(ReadOnlySpan<Char>)	Skriver textrepresentationen av ett teckenintervall till textströmmen följt av en radavgränsare.
WriteLine(Single)	Skriver textrepresentationen av ett flyttal på 4 byte till textströmmen följt av en radavslutare.
WriteLine(String, Object, Object, Object)	Skriver ut en formaterad sträng och en ny rad till textströmmen med samma semantik som Format(String, Object).
WriteLine(String, Object, Object)	Skriver en formaterad sträng och en ny rad till textströmmen med samma semantik som Format(String, Object, Object) metoden.
WriteLine(String, Object)	Skriver en formaterad sträng och en ny rad till textströmmen med samma semantik som Format(String, Object) metoden.
WriteLine(String, Object[])	Skriver ut en formaterad sträng och en ny rad till textströmmen med samma semantik som Format(String, Object).
WriteLine(String)	Skriver en sträng till textströmmen följt av en radavgränsare.
WriteLine(UInt32)	Skriver textrepresentationen av ett osignerat heltal på 4 byte till textströmmen följt av en radavgränsare.
WriteLine(UInt64)	Skriver textrepresentationen av ett osignerat heltal på 8 byte till textströmmen, följt av en radavgränsare.
WriteLineAsync()	Skriver asynkront en radavgränsare till textströmmen.
WriteLineAsync(Char)	Skriver asynkront ett tecken till textströmmen följt av en radavgränsare.
WriteLineAsync(Char[], Int32, Int32)	Skriver asynkront ett underordnat tecken till textströmmen följt av en radavslutare.
WriteLineAsync(Char[])	Skriver asynkront en matris med tecken till textströmmen följt av en radavgränsare.
WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)	Skriver asynkront textrepresentationen av en teckenminnesregion till textströmmen, följt av en radavgränsare.
WriteLineAsync(String)	Skriver asynkront en sträng till textströmmen följt av en radavslutare.

Explicita gränssnittsimplementeringar

Name	Description
IDisposable.Dispose()	En beskrivning av den här medlemmen finns i Dispose().

Tilläggsmetoder

Name	Description
ConfigureAwait(IAsyncDisposable, Boolean)	Konfigurerar hur väntar på de uppgifter som returneras från en asynkron disponibel ska utföras.

Gäller för

Se även

Feedback

Var den här sidan till hjälp?