TextWriter Třída

  • Reference

Definice

Obor názvů:
System.IO
Sestavení:
System.IO.dll
Sestavení:
System.Runtime.dll
Sestavení:
System.Runtime.Extensions.dll
Sestavení:
mscorlib.dll
Sestavení:
netstandard.dll

Představuje zapisovač, který může psát sekvenční řadu znaků. Tato třída je abstraktní.

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
Dědičnost
Object
TextWriter
Dědičnost
Object
MarshalByRefObject
TextWriter
Odvozené
Atributy
SerializableAttribute ComVisibleAttribute
Implementuje
IDisposable IAsyncDisposable

Příklady

Třída TextWriter je abstraktní třída. Proto ho v kódu neodstraňujete. Třída StreamWriter je odvozena z TextWriter a poskytuje implementace členů pro zápis do streamu. Následující příklad ukazuje, jak psát dva řádky, které se skládají z řetězcových hodnot do textového souboru pomocí WriteLineAsync(String) metody.

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

Poznámky

TextWriter je abstraktní základní třída StreamWriter a StringWriterkteré zapisují znaky do datových proudů a řetězců v uvedeném pořadí. Vytvořte instanci TextWriter pro zápis objektu do řetězce, zápis řetězců do souboru nebo serializace XML. Můžete také použít instanci k zápisu TextWriter textu do vlastního backing storu pomocí stejných rozhraní API, která byste použili pro řetězec nebo stream, nebo přidat podporu pro formátování textu.

Write Všechny metody primitivních datových TextWriter typů jako parametry zapisují hodnoty jako řetězce.

Ve výchozím nastavení TextWriter není bezpečné vlákno. Podívejte se TextWriter.Synchronized na obálku bezpečnou pro vlákno.

Důležité

Tento typ implementuje IDisposable rozhraní. Po dokončení použití libovolného typu odvozeného z tohoto typu byste ho měli odstranit buď přímo, nebo nepřímo. Pokud chcete typ odstranit přímo, zavolejte jeho Dispose metodu try/catch v bloku. Pokud ho chcete odstranit nepřímo, použijte konstruktor jazyka, jako using je (v jazyce C#) nebo Using (v Visual Basic). Další informace najdete v tématu rozhraní v IDisposable části Použití objektu, který implementuje IDisposable.

Seznam běžných vstupně-výstupních úloh najdete v tématu Běžné vstupně-výstupní úlohy.

Poznámky pro implementátory

Odvozená třída musí minimálně implementovat metodu Write(Char) , aby byla užitečná instance TextWriter.

Konstruktory

TextWriter()

Inicializuje novou instanci TextWriter třídy.
TextWriter(IFormatProvider)

Inicializuje novou instanci TextWriter třídy se zadaným poskytovatelem formátu.

Pole

CoreNewLine

Uloží znaky nového řádku použité pro tento TextWriterznak .
Null

TextWriter Poskytuje žádné záložní úložiště, do kterého je možné zapisovat, ale ne číst.

Vlastnosti

Encoding

Při přepsání v odvozené třídě vrátí kódování znaků, ve kterém je výstup zapsán.
FormatProvider

Získá objekt, který řídí formátování.
NewLine

Získá nebo nastaví ukončovací řetězec řádku používaný aktuální TextWriter.

Metody

Close()

Zavře aktuální zapisovač a uvolní všechny systémové prostředky přidružené k zapisovači.
CreateObjRef(Type)

Vytvoří objekt, který obsahuje všechny relevantní informace potřebné k vygenerování proxy serveru používaného ke komunikaci se vzdáleným objektem.

(Zděděno od MarshalByRefObject)
Dispose()

Uvolní všechny prostředky používané objektem TextWriter .
Dispose(Boolean)

Uvolní nespravované prostředky používané TextWriter a volitelně uvolní spravované prostředky.
DisposeAsync()

Asynchronně uvolní všechny prostředky používané objektem TextWriter .
Equals(Object)

Určí, zda se zadaný objekt rovná aktuálnímu objektu.

(Zděděno od Object)
Flush()

Vymaže všechny vyrovnávací paměti pro aktuální zapisovač a způsobí zápis všech uložených dat do vyrovnávací paměti do podkladového zařízení.
FlushAsync()

Asynchronně vymaže všechny vyrovnávací paměti pro aktuální zapisovač a způsobí zápis všech uložených dat do podkladového zařízení.
GetHashCode()

Slouží jako výchozí funkce hash.

(Zděděno od Object)
GetLifetimeService()
Zastaralé.

Načte aktuální objekt služby životnosti, který řídí zásady životnosti pro tuto instanci.

(Zděděno od MarshalByRefObject)
GetType()

Type Získá aktuální instanci.

(Zděděno od Object)
InitializeLifetimeService()
Zastaralé.

Získá objekt služby životnosti pro řízení zásad životnosti pro tuto instanci.

(Zděděno od MarshalByRefObject)
MemberwiseClone()

Vytvoří použádnou kopii aktuálního souboru Object.

(Zděděno od Object)
MemberwiseClone(Boolean)

Vytvoří kopii aktuálního objektu bez MarshalByRefObject podmět.

(Zděděno od MarshalByRefObject)
Synchronized(TextWriter)

Vytvoří obálku bezpečnou pro vlákno kolem zadaného TextWriter.
ToString()

Vrátí řetězec, který představuje aktuální objekt.

(Zděděno od Object)
Write(Boolean)

Zapíše textovou reprezentaci hodnoty do textového Boolean streamu.
Write(Char)

Zapíše znak do textového streamu.
Write(Char[])

Zapíše pole znaků do textového streamu.
Write(Char[], Int32, Int32)

Zapíše podarray znaků do textového streamu.
Write(Decimal)

Zapíše textovou reprezentaci desetinné hodnoty do textového streamu.
Write(Double)

Zapíše textovou reprezentaci hodnoty s plovoucí desetinnou čárkou 8 bajtů do textového streamu.
Write(Int32)

Zapíše textovou reprezentaci 4bajtů podepsaného celé číslo do textového streamu.
Write(Int64)

Zapíše textovou reprezentaci 8bajtů podepsaného celé číslo do textového streamu.
Write(Object)

Zapíše textovou reprezentaci objektu do textového datového proudu voláním ToString metody na daném objektu.
Write(ReadOnlySpan<Char>)

Zapíše rozsah znaků do textového streamu.
Write(Single)

Zapíše textovou reprezentaci 4 bajtové hodnoty s plovoucí desetinou čárkou do textového streamu.
Write(String)

Zapíše řetězec do textového streamu.
Write(String, Object)

Zapíše formátovaný řetězec do textového streamu pomocí stejné sémantiky jako Format(String, Object) metoda.
Write(String, Object, Object)

Zapíše formátovaný řetězec do textového streamu pomocí stejné sémantiky jako Format(String, Object, Object) metoda.
Write(String, Object, Object, Object)

Zapíše formátovaný řetězec do textového streamu pomocí stejné sémantiky jako Format(String, Object, Object, Object) metoda.
Write(String, Object[])

Zapíše formátovaný řetězec do textového streamu pomocí stejné sémantiky jako Format(String, Object[]) metoda.
Write(StringBuilder)

Zapíše tvůrce řetězců do textového streamu.
Write(UInt32)

Zapíše textovou reprezentaci 4bajtů bez znaménka do textového streamu.
Write(UInt64)

Zapíše textovou reprezentaci 8bajtů bez znaménka do textového streamu.
WriteAsync(Char)

Zapíše znak do textového streamu asynchronně.
WriteAsync(Char[])

Zapíše pole znaků do textového streamu asynchronně.
WriteAsync(Char[], Int32, Int32)

Zapíše dílčí znaky do textového streamu asynchronně.
WriteAsync(ReadOnlyMemory<Char>, CancellationToken)

Asynchronně zapíše oblast paměti znaků do textového streamu.
WriteAsync(String)

Zapíše řetězec do textového streamu asynchronně.
WriteAsync(StringBuilder, CancellationToken)

Asynchronně zapíše tvůrce řetězců do textového streamu.
WriteLine()

Zapíše ukončovací znak řádku do textového streamu.
WriteLine(Boolean)

Zapíše textovou reprezentaci hodnoty do textového Boolean streamu následovanou ukončovacím znakem řádku.
WriteLine(Char)

Zapíše znak do textového streamu následovaný ukončovacím znakem řádku.
WriteLine(Char[])

Zapíše pole znaků do textového streamu následované ukončovacím znakem řádku.
WriteLine(Char[], Int32, Int32)

Zapíše podarray znaků do textového streamu následovaný ukončovacím znakem řádku.
WriteLine(Decimal)

Zapíše textovou reprezentaci desetinné hodnoty do textového streamu následovanou ukončovacím znakem řádku.
WriteLine(Double)

Zapíše textovou reprezentaci hodnoty s plovoucí desetinnou čárkou 8 bajtů do textového streamu a za ní ukončovací znak řádku.
WriteLine(Int32)

Zapíše textovou reprezentaci 4bajtů podepsaného celé číslo do textového streamu následované ukončovacím znakem řádku.
WriteLine(Int64)

Zapíše textovou reprezentaci 8bajtů podepsaného celé číslo do textového streamu následované ukončovacím znakem řádku.
WriteLine(Object)

Zapíše textovou reprezentaci objektu do textového datového proudu voláním ToString metody na objektu následovanou ukončovacím znakem řádku.
WriteLine(ReadOnlySpan<Char>)

Zapíše textovou reprezentaci rozsahu znaků do textového streamu, za kterým následuje ukončovací čára.
WriteLine(Single)

Zapíše textovou reprezentaci 4 bajtové hodnoty s plovoucí desetinou čárkou do textového datového proudu a za ním ukončete čáru.
WriteLine(String)

Zapíše řetězec do textového streamu, za kterým následuje ukončovací čára.
WriteLine(String, Object)

Zapíše formátovaný řetězec a nový řádek do textového streamu pomocí stejné sémantiky jako Format(String, Object) metoda.
WriteLine(String, Object, Object)

Zapíše formátovaný řetězec a nový řádek do textového streamu Format(String, Object, Object) pomocí stejné sémantiky jako metoda.
WriteLine(String, Object, Object, Object)

Zapíše formátovaný řetězec a nový řádek do textového streamu pomocí stejné sémantiky jako Format(String, Object).
WriteLine(String, Object[])

Zapíše formátovaný řetězec a nový řádek do textového streamu pomocí stejné sémantiky jako Format(String, Object).
WriteLine(StringBuilder)

Zapíše textovou reprezentaci tvůrce řetězců do textového datového proudu následovaného ukončovacím řádkem.
WriteLine(UInt32)

Zapíše textovou reprezentaci 4bajtů bez znaménka do textového datového proudu, za kterým následuje ukončovací čára.
WriteLine(UInt64)

Zapíše textovou reprezentaci 8bajtů bez znaménka do textového datového proudu následovaného ukončovacím znakem řádku.
WriteLineAsync()

Asynchronně zapíše ukončovací znak řádku do textového streamu.
WriteLineAsync(Char)

Asynchronně zapíše znak do textového streamu následovaný ukončovacím znakem řádku.
WriteLineAsync(Char[])

Asynchronně zapíše pole znaků do textového streamu následované ukončovacím znakem řádku.
WriteLineAsync(Char[], Int32, Int32)

Asynchronně zapíše dílčí znaky do textového streamu následovaný ukončovacím znakem řádku.
WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)

Asynchronně zapisuje textovou reprezentaci oblasti paměti znaku do textového streamu následované ukončovacím znakem řádku.
WriteLineAsync(String)

Asynchronně zapíše řetězec do textového streamu následovaný ukončovacím znakem řádku.
WriteLineAsync(StringBuilder, CancellationToken)

Asynchronně zapisuje textovou reprezentaci tvůrce řetězců do textového streamu následované ukončovacím znakem řádku.

Explicitní implementace rozhraní

IDisposable.Dispose()

Popis tohoto člena naleznete v tématu Dispose().

Metody rozšíření

ConfigureAwait(IAsyncDisposable, Boolean)

Nakonfiguruje, jak se čekají na úlohy vrácené z asynchronního jednorázového provedení.

Platí pro

Viz také