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
Zdroj:
TextWriter.cs
Zdroj:
TextWriter.cs
Zdroj:
TextWriter.cs

Představuje zapisovač, který může napsat 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 ji v kódu neodstraňujete. Třída StreamWriter je odvozena z TextWriter a poskytuje implementace členů pro zápis do datového proudu. Následující příklad ukazuje, jak zapsat 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 StringWriter, která zapisuje znaky do datových proudů a řetězců v uvedeném pořadí. Instance TextWriter slouží k zápisu objektu do řetězce, zápisu řetězců do souboru nebo serializace XML. Instanci TextWriter můžete také použít k zápisu textu do vlastního záložního úložiště pomocí stejných rozhraní API, která byste použili pro řetězec nebo datový proud, nebo k přidání podpory formátování textu.

Všechny Write metody TextWriter, které mají primitivní datové typy jako parametry, zapisují hodnoty jako řetězce.

Ve výchozím nastavení není TextWriter bezpečný pro přístup z více vláken. Viz TextWriter.Synchronized obálky bezpečné pro vlákno.

Důležitý

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

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

Poznámky pro implementátory

Odvozená třída musí minimálně implementovat Write(Char) metodu, 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

Ukládá znaky nového řádku použité pro tento TextWriter.
Null

Poskytuje TextWriter bez záložního úložiště, do kterého lze 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ím TextWriter.

Metody

Close()

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

Vytvoří instanci TextWriter, která zapisuje zadané vstupy každému zapisovači v writers.
CreateObjRef(Type)

Vytvoří objekt, který obsahuje všechny relevantní informace potřebné k vygenerování proxy serveru sloužící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čuje, zda je zadaný objekt roven 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 dat uložených 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 základního zařízení.
FlushAsync(CancellationToken)

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 základního zařízení.
GetHashCode()

Slouží jako výchozí funkce hash.

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

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

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

Získá Type aktuální instance.

(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ří mělkou kopii aktuálního Object.

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

Vytvoří mělkou kopii aktuálního objektu MarshalByRefObject.

(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 Boolean do textového 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 dílčí pole 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í desetinou čárkou 8 bajtů do textového datového proudu.
Write(Int32)

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

Zapíše textovou reprezentaci 8 bajtového celého čísla 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 4bajtů 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(String, ReadOnlySpan<Object>)

Zapíše formátovaný řetězec do textového streamu pomocí stejné sémantiky jako Format(String, ReadOnlySpan<Object>).
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čí pole znaků 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 Boolean hodnoty do textového datového proudu následovaného 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 do textového streamu matici znaků následovanou ukončovacím znakem řádku.
WriteLine(Char[], Int32, Int32)

Zapíše dílčí pole znaků do textového streamu následovaného ukončovacím řádkem.
WriteLine(Decimal)

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

Zapíše textovou reprezentaci 8 bajtové hodnoty s plovoucí desetinou čárkou do textového datového proudu následovaného ukončovacím znakem řádku.
WriteLine(Int32)

Zapíše textovou reprezentaci 4 bajtového celého čísla do textového streamu následovaného ukončovacím řádkem.
WriteLine(Int64)

Zapíše textovou reprezentaci 8 bajtového celého čísla do textového streamu následovaného ukončovacím řádkem.
WriteLine(Object)

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

Zapíše textovou reprezentaci rozsahu znaků do textového streamu následovaného ukončovacím řádkem.
WriteLine(Single)

Zapíše textovou reprezentaci 4bajtů s plovoucí desetinou čárkou do textového datového proudu následovaného ukončovacím znakem řádku.
WriteLine(String)

Zapíše řetězec do textového streamu následovaného ukončovacím znakem řádku.
WriteLine(String, Object)

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

Zapíše formátovaný řetězec a nový řádek do textového streamu pomocí stejné sémantiky jako metoda Format(String, Object, Object).
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(String, ReadOnlySpan<Object>)

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

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

Zapíše textovou reprezentaci 4bajtů bez znaménka do textového datového proudu následovaného ukončovacím znakem řádku.
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 datového proudu následovaného ukončovacím řádkem.
WriteLineAsync(Char[], Int32, Int32)

Asynchronně zapíše dílčí pole znaků do textového streamu následovaného ukončovacím řádkem.
WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)

Asynchronně zapíše textovou reprezentaci oblasti paměti znaku do textového streamu následovaného ukončovacím řádkem.
WriteLineAsync(String)

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

Asynchronně zapíše textovou reprezentaci tvůrce řetězců do textového streamu následovaného ukončovacím řádkem.

Explicitní implementace rozhraní

IDisposable.Dispose()

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

Metody rozšíření

ConfigureAwait(IAsyncDisposable, Boolean)

Konfiguruje, jak čekají na úlohy vrácené z asynchronního jednorázového použití.

Platí pro

Viz také