TextWriter Třída

Definice

Obor názvů:

System.IO

Sestavení:

System.Runtime.dll

Zdroj:

TextWriter.cs

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

public ref class TextWriter abstract : MarshalByRefObject, IAsyncDisposable, IDisposable

public abstract class TextWriter : MarshalByRefObject, IAsyncDisposable, IDisposable

type TextWriter = class
    inherit MarshalByRefObject
    interface IAsyncDisposable
    interface IDisposable

Public MustInherit Class TextWriter
Inherits MarshalByRefObject
Implements IAsyncDisposable, IDisposable

Dědičnost

Object

MarshalByRefObject

TextWriter

Odvozené

System.CodeDom.Compiler.IndentedTextWriter

System.IO.StreamWriter

System.IO.StringWriter

System.Web.HttpWriter

System.Web.UI.HtmlTextWriter

Implementuje

IDisposable IAsyncDisposable

Příklady

Třída TextWriter je abstraktní třída. Proto se v kódu nevytvořuje instance. 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 pomocí metody zapsat dva řádky, které se skládají z řetězcových hodnot do textového WriteLineAsync(String) souboru.

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í. Pomocí instance použijte TextWriter k zápisu objektu do řetězce, k zápisu řetězců do souboru nebo k serializaci XML. Instanci můžete použít také k zápisu textu do vlastního záložního TextWriter ú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ý z TextWriter více vláken. Podívejte TextWriter.Synchronized se na obálku bezpečnou pro vlákna.

Důležité

Tento typ implementuje IDisposable rozhraní. Po dokončení použití jakéhokoli typu, který je odvozen od tohoto typu, byste ho měli odstranit přímo nebo nepřímo. Pokud chcete odstranit typ přímo, zavolejte jeho Dispose metodu try/catch v bloku. Pokud ho chcete odstranit nepřímo, použijte konstruktor jazyka, například using (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 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 zprostředkovatelem formátu.

Pole

CoreNewLine	Ukládá znaky nového řádku použité pro tento .TextWriter
Null	TextWriter Poskytuje bez záložního úložiště, 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 zapsán výstup.
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 sloužící 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é nástrojem 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 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 aktuální životnost objektu služby, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
InitializeLifetimeService()	Zastaralé. Získá životnost objektu služby, 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 přístup z více vláken kolem zadaného TextWritersouboru .
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)
Write(Boolean)	Zapíše textovou reprezentaci Boolean 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 dílčí pole znaků do textového streamu.
Write(Decimal)	Zapíše textovou reprezentaci desetinné hodnoty do textového proudu.
Write(Double)	Zapíše textovou reprezentaci hodnoty 8 bajtů s plovoucí desetinou čárkou do textového streamu.
Write(Int32)	Zapíše textovou reprezentaci 4 bajtového celého čísla se 4 bajty do textového datového proudu.
Write(Int64)	Zapíše do textového datového proudu textovou reprezentaci 8 bajtů se psaných čísly se sadou 8 bajtů.
Write(Object)	Zapíše textovou reprezentaci objektu do textového streamu voláním ToString metody pro tento objekt.
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 4 bajtového celého čísla bez znaménka do textového streamu.
Write(UInt64)	Zapíše textovou reprezentaci 8 bajtového celého čísla 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 znakové paměti 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 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 dílčí pole znaků do textového streamu následované ukončovacím znakem řádku.
WriteLine(Decimal)	Zapíše textovou reprezentaci desetinné hodnoty do textového proudu následovaného ukončovacím znakem řádku.
WriteLine(Double)	Zapíše textovou reprezentaci hodnoty s plovoucí desetinou čárkou o velikosti 8 bajtů do textového proudu následovanou ukončovacím znakem řádku.
WriteLine(Int32)	Zapíše textovou reprezentaci 4 bajtového podepsaného celého čísla do textového streamu následovaného ukončovacím znakem řádku.
WriteLine(Int64)	Zapíše textovou reprezentaci 8 bajtů podepsaného celého čísla do textového streamu následovaného ukončovacím znakem řádku.
WriteLine(Object)	Zapíše textovou reprezentaci objektu do textového streamu voláním ToString metody pro tento objekt následovaný 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 hodnoty s plovoucí desetinou čárkou o velikosti 4 bajtů do textového proudu 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ásledovaného ukončovacím znakem řádku.
WriteLine(UInt32)	Zapíše textovou reprezentaci 4 bajtového celého čísla bez znaménka do textové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 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čí pole znaků do textového streamu následované ukončovacím znakem řádku.
WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)	Asynchronně zapíše textovou reprezentaci oblasti znakové paměti 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.

Metody rozšíření

ConfigureAwait(IAsyncDisposable, Boolean)

Konfiguruje, jak se provádí funkce awaits u úloh vrácených z asynchronního jednorázového režimu.

Viz také

• StreamWriter
• StringWriter
• Vstupně-výstupní operace souborů a datových proudů
• Postupy: Čtení textu ze souboru
• Postupy: Zápis textu do souboru
• Postupy: Čtení a zápis do nově vytvořeného datového souboru