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 zapisovatel, 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 ji v kódu nevytvoř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 WriteLineAsync(String) souboru pomocí 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 a StreamWriterStringWriter, která zapisuje 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 serializaci XML. Instanci můžete použít také k zápisu TextWriter 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.

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

Ve výchozím nastavení není bezpečný pro TextWriter přístup z více vláken. Podívejte TextWriter.Synchronized se na obálku bezpečnou pro přístup z více vláken.

Důležité

Tento typ implementuje IDisposable rozhraní . Po dokončení používání jakéhokoli typu, který je odvozen z tohoto typu, byste ho měli odstranit přímo nebo nepřímo. Chcete-li odstranit typ 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 jazyce Visual Basic). Další informace najdete v tématu Dispose a v části "Použití objektu, který implementuje IDisposable" v IDisposable tématu rozhraní.

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 metoduWrite(Char), aby byla užitečná instance .TextWriter

Konstruktory

TextWriter()

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

Inicializuje novou instanci TextWriter třídy pomocí zadaného zprostředkovatele formátu.

Pole

CoreNewLine

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

TextWriter Poskytuje úložiště bez backingu, do kterého se dá 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í řetězec ukončovací čáry 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 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 nástrojem 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 dat do vyrovnávací paměti do základního zařízení.
FlushAsync()

Asynchronně vymaže všechny vyrovnávací paměti pro aktuální zapisovač a způsobí zápis všech dat do vyrovnávací paměti 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 dat do vyrovnávací paměti do základního zařízení.
GetHashCode()

Slouží jako výchozí hashovací funkce.

(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á aktuální Type instanci.

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

Získá objekt služby životnosti, který řídí zásady životnosti pro tuto instanci.

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

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

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

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

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

Vytvoří obálku bezpečnou pro vlákna 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 Boolean reprezentaci hodnoty 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 do textového datového proudu podadresu znaků.
Write(Decimal)

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

Zapíše do textového datového proudu textovou reprezentaci hodnoty s plovoucí desetinou čárkou o velikosti 8 bajtů.
Write(Int32)

Zapíše do textového datového proudu textovou reprezentaci 4 bajtového celého čísla.
Write(Int64)

Zapíše do textového streamu textovou reprezentaci 8 bajtového celého čísla.
Write(Object)

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

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

Zapíše textovou reprezentaci hodnoty s plovoucí desetinou čárkou o velikosti 4 bajtů do textového datového proudu.
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 celé číslo do textového streamu.
Write(UInt64)

Zapíše textovou reprezentaci 8bajtů bez znaménka celé číslo 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 do textového streamu asynchronně podadresu znaků.
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 Boolean reprezentaci hodnoty do textového streamu následovaný 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 do textového datového proudu podadresu znaků následovanou ukončovacím znakem řádku.
WriteLine(Decimal)

Zapíše textovou reprezentaci desetinné hodnoty do textového streamu následovaného ukončovacím znakem řádku.
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 do textového streamu textovou reprezentaci 4 bajtového celého čísla, za kterým následuje ukončovací znak řádku.
WriteLine(Int64)

Zapíše do textového datového proudu textovou reprezentaci 8-bajtového celého čísla následovaného ukončovacím znakem řádku.
WriteLine(Object)

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

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

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

Zapíše řetězec do textového streamu následovaný 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 Format(String, Object) metoda.
WriteLine(String, Object, Object)

Zapíše formátovaný řetězec a nový řádek do textového streamu pomocí stejné sémantiky jako Format(String, Object, Object) 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 streamu následovanou ukončovacím znakem řádku.
WriteLine(UInt32)

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

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

Asynchronně zapíše ukončovač řádků 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 do textového datového proudu podadresu znaků následovanou ukončovacím znakem řádku.
WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)

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

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

Asynchronně zapíše 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 najdete v tématu Dispose().

Metody rozšíření

ConfigureAwait(IAsyncDisposable, Boolean)

Konfiguruje, jak se provádí čekání na úlohy vrácené z asynchronního jednorázového použití.

Platí pro

Viz také