TextWriter Osztály

Definíció

Névtér:
System.IO
Szerelvények:
mscorlib.dll, System.IO.dll
Szerelvények:
netstandard.dll, System.Runtime.dll
Szerelvény:
System.IO.dll
Szerelvény:
System.Runtime.Extensions.dll
Szerelvény:
mscorlib.dll
Szerelvény:
netstandard.dll
Forrás:
TextWriter.cs
Forrás:
TextWriter.cs
Forrás:
TextWriter.cs
Forrás:
TextWriter.cs
Forrás:
TextWriter.cs

Olyan írót jelöl, amely szekvenciális karaktersorozatot tud írni. Ez az osztály absztrakt.

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
Öröklődés
Object
TextWriter
Öröklődés
Object
MarshalByRefObject
TextWriter
Származtatott
Attribútumok
SerializableAttribute ComVisibleAttribute
Megvalósítás
IDisposable IAsyncDisposable

Példák

Az TextWriter osztály egy absztrakt osztály. Ezért nem példányosíthatja azt a kódban. Az StreamWriter osztály a tagokból származik TextWriter , és implementációkat biztosít a tagok számára a streambe való íráshoz. Az alábbi példa bemutatja, hogyan írhat két sztringértékből álló sort egy szövegfájlba a WriteLineAsync(String) metódus használatával.

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

Megjegyzések

TextWritera streamekre és StreamWritersztringekre írt karakterek absztrakt alaposztályaStringWriter. Objektum sztringbe írása TextWriter , sztringek fájlba írása vagy XML szerializálása. Azt is megteheti, hogy a példánnyal TextWriter szöveget ír egy egyéni háttértárba ugyanazokkal az API-kkal, mint egy sztringhez vagy streamhez, vagy támogatja a szövegformázást.

Write A primitív adattípusok paraméterként való megírásának TextWriter összes metódusa sztringekként írja ki az értékeket.

Alapértelmezés szerint az a TextWriter nem biztonságos szál. Tekintse meg TextWriter.Synchronized a szálbiztos burkolót.

Important

Ez a típus implementálja a IDisposable felületet. Ha befejezte a típus használatát, közvetlenül (a metódus meghívásával) vagy közvetetten (például using a C#-ban) kell elhelyeznie Dispose a típust. További információ: Az IDisposable-t megvalósító objektum használata.

A gyakori I/O-feladatok listáját a Gyakori I/O-feladatok című témakörben találja.

Megjegyzések az implementálókhoz

A származtatott osztálynak minimálisan végre kell hajtania a Write(Char) metódust a hasznos példány létrehozásához TextWriter.

Konstruktorok

Name Description
TextWriter()

Inicializálja a TextWriter osztály új példányát.
TextWriter(IFormatProvider)

Inicializálja az osztály új példányát TextWriter a megadott formátumszolgáltatóval.

Mezők

Name Description
CoreNewLine

A az ehhez használt új vonalkarakterek TextWritertárolására szolgál.
Null

Olyan háttértárat TextWriter biztosít, amelybe írható, de nem olvasható.

Tulajdonságok

Name Description
Encoding

Ha egy származtatott osztályban felül van bírálva, azt a karakterkódolást adja vissza, amelyben a kimenet meg van írva.
FormatProvider

Lekéri a formázást vezérlő objektumot.
NewLine

Lekéri vagy beállítja az aktuális TextWriteráltal használt vonal-terminátor sztringet.

Metódusok

Name Description
Close()

Bezárja az aktuális írót, és felszabadítja az íróhoz társított rendszererőforrásokat.
CreateBroadcasting(TextWriter[])

Létrehoz egy példányt TextWriter , amely a megadott bemeneteket adja meg az egyes írók számára a következőben writers: .
CreateObjRef(Type)

Létrehoz egy objektumot, amely tartalmazza a távoli objektumokkal való kommunikációhoz használt proxy létrehozásához szükséges összes releváns információt.

(Öröklődés forrása MarshalByRefObject)
Dispose()

Felszabadítja az objektum által használt összes erőforrást TextWriter .
Dispose(Boolean)

Felszabadítja a felügyelt erőforrások által TextWriter használt nem felügyelt erőforrásokat, és opcionálisan felszabadítja a felügyelt erőforrásokat.
DisposeAsync()

Aszinkron módon felszabadítja az objektum által használt összes erőforrást TextWriter .
Equals(Object)

Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal.

(Öröklődés forrása Object)
Flush()

Törli az aktuális író összes pufferét, és a pufferelt adatokat a mögöttes eszközre írja.
FlushAsync()

Aszinkron módon törli az aktuális író összes pufferét, és a pufferelt adatokat a mögöttes eszközre írja.
FlushAsync(CancellationToken)

Aszinkron módon törli az aktuális író összes pufferét, és a pufferelt adatokat a mögöttes eszközre írja.
GetHashCode()

Ez az alapértelmezett kivonatoló függvény.

(Öröklődés forrása Object)
GetLifetimeService()
Elavult.

Lekéri a példány élettartamszabályzatát vezérlő aktuális élettartam-szolgáltatásobjektumot.

(Öröklődés forrása MarshalByRefObject)
GetType()

Lekéri az Type aktuális példányt.

(Öröklődés forrása Object)
InitializeLifetimeService()
Elavult.

Beolvas egy élettartam-szolgáltatásobjektumot a példány élettartam-szabályzatának szabályozásához.

(Öröklődés forrása MarshalByRefObject)
MemberwiseClone()

Az aktuális Objectpéldány sekély másolatát hozza létre.

(Öröklődés forrása Object)
MemberwiseClone(Boolean)

Az aktuális MarshalByRefObject objektum sekély másolatát hozza létre.

(Öröklődés forrása MarshalByRefObject)
Synchronized(TextWriter)

Szálbiztos burkolót hoz létre a megadott TextWriterkörül.
ToString()

Az aktuális objektumot jelképező sztringet ad vissza.

(Öröklődés forrása Object)
Write(Boolean)

Egy érték szöveges ábrázolását Boolean írja a szövegstreambe.
Write(Char)

Karaktert ír a szövegfolyamba.
Write(Char[], Int32, Int32)

Karakterek alarráit írja a szövegstreambe.
Write(Char[])

Karaktertömböt ír a szövegstreambe.
Write(Decimal)

Decimális érték szöveges ábrázolását írja a szövegfolyamba.
Write(Double)

Egy 8 bájtos lebegőpontos érték szöveges ábrázolását írja a szövegfolyamba.
Write(Int32)

Egy 4 bájtos aláírt egész szám szöveges ábrázolását írja a szövegstreambe.
Write(Int64)

Egy 8 bájtos aláírt egész szám szöveges ábrázolását írja a szövegstreambe.
Write(Object)

Egy objektum szöveges ábrázolását írja a szövegstreambe az ToString objektum metódusának meghívásával.
Write(ReadOnlySpan<Char>)

Karaktert ír a szövegfolyamba.
Write(Rune)

Olyan írót jelöl, amely szekvenciális karaktersorozatot tud írni. Ez az osztály absztrakt.
Write(Single)

Egy 4 bájtos lebegőpontos érték szöveges ábrázolását írja a szövegstreambe.
Write(String, Object, Object, Object)

Formázott sztringet ír a szövegstreambe ugyanazzal a szemantikával, mint a Format(String, Object, Object, Object) metódus.
Write(String, Object, Object)

Formázott sztringet ír a szövegfolyamba ugyanazzal a szemantikával, mint a Format(String, Object, Object) metódus.
Write(String, Object)

Formázott sztringet ír a szövegstreambe ugyanazzal a szemantikával, mint a Format(String, Object) metódus.
Write(String, Object[])

Formázott sztringet ír a szövegstreambe ugyanazzal a szemantikával, mint a Format(String, Object[]) metódus.
Write(String, ReadOnlySpan<Object>)

Formázott sztringet ír a szövegfolyamba ugyanazzal a szemantikával, mint Format(String, ReadOnlySpan<Object>)a .
Write(String)

Sztringet ír a szövegstreambe.
Write(StringBuilder)

Sztringszerkesztőt ír a szövegstreambe.
Write(UInt32)

Egy 4 bájtos, aláíratlan egész szám szöveges ábrázolását írja a szövegstreambe.
Write(UInt64)

Egy 8 bájtos, aláíratlan egész szám szöveges ábrázolását írja a szövegfolyamba.
WriteAsync(Char)

Aszinkron módon ír egy karaktert a szövegfolyamba.
WriteAsync(Char[], Int32, Int32)

A karakterek alarráit aszinkron módon írja a szövegstreambe.
WriteAsync(Char[])

Karaktertömb írása aszinkron módon a szövegfolyamba.
WriteAsync(ReadOnlyMemory<Char>, CancellationToken)

Aszinkron módon ír egy karaktermemóriaterületet a szövegstreambe.
WriteAsync(Rune)

Olyan írót jelöl, amely szekvenciális karaktersorozatot tud írni. Ez az osztály absztrakt.
WriteAsync(String, CancellationToken)

Olyan írót jelöl, amely szekvenciális karaktersorozatot tud írni. Ez az osztály absztrakt.
WriteAsync(String)

Sztringet ír a szövegstreambe aszinkron módon.
WriteAsync(StringBuilder, CancellationToken)

Aszinkron módon sztringszerkesztőt ír a szövegstreambe.
WriteLine()

Egy sorkiadót ír a szövegstreambe.
WriteLine(Boolean)

Egy érték szöveges ábrázolását Boolean írja a szövegstreambe, majd egy sorkiadót.
WriteLine(Char)

Karaktert ír a szövegfolyamba, majd egy sorkiválasztót.
WriteLine(Char[], Int32, Int32)

A szövegfolyamba karakterek alarráit írja, amelyet egy sorkiválasztó követ.
WriteLine(Char[])

Egy karaktertömböt ír a szövegstreambe, amelyet egy sor terminátor követ.
WriteLine(Decimal)

Egy decimális érték szöveges ábrázolását írja a szövegfolyamba, majd egy sorkiválasztót.
WriteLine(Double)

Egy 8 bájtos lebegőpontos érték szöveges ábrázolását írja a szövegfolyamba, majd egy sorkijelölőt.
WriteLine(Int32)

Egy 4 bájtos aláírt egész szám szöveges ábrázolását írja a szövegfolyamba, majd egy sorkijelölőt.
WriteLine(Int64)

Egy 8 bájtos aláírt egész szám szöveges ábrázolását írja a szövegfolyamba, majd egy sorkijelölőt.
WriteLine(Object)

Egy objektum szövegábrázolását írja a szövegstreambe a metódus meghívásával ToString az objektumon, majd egy sorkiadóval.
WriteLine(ReadOnlySpan<Char>)

Egy karaktersor szöveges ábrázolását írja a szövegfolyamba, majd egy sorkiválasztót.
WriteLine(Rune)

Olyan írót jelöl, amely szekvenciális karaktersorozatot tud írni. Ez az osztály absztrakt.
WriteLine(Single)

Egy 4 bájtos lebegőpontos érték szöveges ábrázolását írja a szövegfolyamba, majd egy sorkijelölőt.
WriteLine(String, Object, Object, Object)

Formázott sztringet és egy új sort ír ki a szövegfolyamba ugyanazzal a szemantikával, mint Format(String, Object)a .
WriteLine(String, Object, Object)

Formázott sztringet és egy új sort ír a szövegfolyamba ugyanazzal a szemantikával, mint a Format(String, Object, Object) metódus.
WriteLine(String, Object)

Formázott sztringet és egy új sort ír a szövegfolyamba ugyanazzal a szemantikával, mint a Format(String, Object) metódus.
WriteLine(String, Object[])

Formázott sztringet és egy új sort ír ki a szövegfolyamba ugyanazzal a szemantikával, mint Format(String, Object)a .
WriteLine(String, ReadOnlySpan<Object>)

Formázott sztringet és egy új sort ír ki a szövegfolyamba ugyanazzal a szemantikával, mint Format(String, ReadOnlySpan<Object>)a .
WriteLine(String)

Sztringet ír a szövegfolyamba, majd egy sorkiválasztót.
WriteLine(StringBuilder)

Egy sztringszerkesztő szövegábrázolását írja a szövegfolyamba, majd egy sorkiadót.
WriteLine(UInt32)

Egy 4 bájtos, aláíratlan egész szám szöveges ábrázolását írja a szövegfolyamba, majd egy sorkijelzőt.
WriteLine(UInt64)

Egy 8 bájtból álló, aláíratlan egész szám szöveges ábrázolását írja a szövegfolyamba, majd egy sorkijelzőt.
WriteLineAsync()

Aszinkron módon egy sor terminátort ír a szövegstreambe.
WriteLineAsync(CancellationToken)

Olyan írót jelöl, amely szekvenciális karaktersorozatot tud írni. Ez az osztály absztrakt.
WriteLineAsync(Char)

Aszinkron módon ír egy karaktert a szövegfolyamba, majd egy sor terminátort.
WriteLineAsync(Char[], Int32, Int32)

Aszinkron módon a karakterek egy részarráját írja a szövegfolyamba, amelyet egy sor terminátor követ.
WriteLineAsync(Char[])

Aszinkron módon egy karaktertömböt ír a szövegstreambe, amelyet egy sorkiválasztó követ.
WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)

Aszinkron módon egy karaktermemória-régió szöveges ábrázolását írja a szövegfolyamba, majd egy sorkiválasztót.
WriteLineAsync(Rune)

Olyan írót jelöl, amely szekvenciális karaktersorozatot tud írni. Ez az osztály absztrakt.
WriteLineAsync(String, CancellationToken)

Olyan írót jelöl, amely szekvenciális karaktersorozatot tud írni. Ez az osztály absztrakt.
WriteLineAsync(String)

Aszinkron módon sztringet ír a szövegfolyamba, majd egy sorkiadót.
WriteLineAsync(StringBuilder, CancellationToken)

Aszinkron módon egy sztringszerkesztő szövegábrázolását írja a szövegfolyamba, majd egy sor terminátort.

Explicit interfész-implementációk

Name Description
IDisposable.Dispose()

Ennek a tagnak a leírását lásd Dispose(): .

Bővítő metódusok

Name Description
ConfigureAwait(IAsyncDisposable, Boolean)

Konfigurálja, hogy az aszinkron eldobható feladatok hogyan lesznek végrehajtva.

A következőre érvényes:

Lásd még