TextWriter Třída

Definice

Představuje zapisovač, který může napsat posloupnost řady znaků.Represents a writer that can write a sequential series of characters. Tato třída je abstraktní.This class is abstract.

public ref class TextWriter abstract : IDisposable
public ref class TextWriter abstract : MarshalByRefObject, IDisposable
public ref class TextWriter abstract : MarshalByRefObject, IAsyncDisposable, IDisposable
public abstract class TextWriter : IDisposable
public abstract class TextWriter : MarshalByRefObject, IDisposable
public abstract class TextWriter : MarshalByRefObject, IAsyncDisposable, IDisposable
[System.Serializable]
public abstract class TextWriter : MarshalByRefObject, IDisposable
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public abstract class TextWriter : MarshalByRefObject, IDisposable
type TextWriter = class
    interface IDisposable
type TextWriter = class
    inherit MarshalByRefObject
    interface IDisposable
type TextWriter = class
    inherit MarshalByRefObject
    interface IAsyncDisposable
    interface IDisposable
Public MustInherit Class TextWriter
Implements IDisposable
Public MustInherit Class TextWriter
Inherits MarshalByRefObject
Implements IDisposable
Public MustInherit Class TextWriter
Inherits MarshalByRefObject
Implements IAsyncDisposable, IDisposable
Dědičnost
TextWriter
Dědičnost
Odvozené
Atributy
Implementuje

Příklady

Třída TextWriter je abstraktní třída.The TextWriter class is an abstract class. Proto nevytvářejte instance v kódu.Therefore, you do not instantiate it in your code. Třída StreamWriter je odvozena z TextWriter a poskytuje implementace členů pro zápis do datového proudu.The StreamWriter class derives from TextWriter and provides implementations of the members for writing to a stream. Následující příklad ukazuje, jak zapsat dva řádky, které se skládají z řetězcových hodnot do textového souboru pomocí metody WriteLineAsync(String).The following example shows how to write two lines that consist of string values to a text file by using the WriteLineAsync(String) method.

Přepsat Dispose v odvozené třídě k poskytnutíOverride Dispose in a derived class to provide

using System;
using System.IO;

namespace ConsoleApplication
{
    class Program
    {
        static void Main(string[] args)
        {
            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í.TextWriter is the abstract base class of StreamWriter and StringWriter, which write characters to streams and strings, respectively. Vytvořte instanci TextWriter pro zápis objektu do řetězce, zápis řetězců do souboru nebo serializaci kódu XML.Create an instance of TextWriter to write an object to a string, write strings to a file, or to serialize XML. Můžete také použít instanci TextWriter 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 pro přidání podpory pro formátování textu.You can also use an instance of TextWriter to write text to a custom backing store using the same APIs you would use for a string or a stream, or to add support for text formatting.

Všechny metody Write TextWriter s primitivními datovými typy jako parametry zapisují hodnoty jako řetězce.All the Write methods of TextWriter having primitive data types as parameters write out the values as strings.

Ve výchozím nastavení není TextWriter bezpečná pro přístup z více vláken.By default, a TextWriter is not thread safe. Obálku bezpečnou pro přístup z více vláken najdete v tématu TextWriter.Synchronized.See TextWriter.Synchronized for a thread-safe wrapper.

Důležité

Tento typ implementuje rozhraní IDisposable.This type implements the IDisposable interface. Po dokončení používání libovolného typu, který je odvozen z tohoto typu, byste jej měli přímo nebo nepřímo odstranit.When you have finished using any type that derives from this type, you should dispose of it either directly or indirectly. Chcete-li přímo uvolnit typ, zavolejte jeho metodu Dispose v try/catch bloku.To dispose of the type directly, call its Dispose method in a try/catch block. Chcete-li ji nakládat nepřímo, použijte konstrukci jazyka, například using ( C#in) nebo Using (v Visual Basic).To dispose of it indirectly, use a language construct such as using (in C#) or Using (in Visual Basic). Další informace naleznete v části Dispose a "using a Object implementující IDisposable" v tématu IDisposable Interface.For more information, see Dispose and the "Using an Object that Implements IDisposable" section in the IDisposable interface topic.

Seznam běžných vstupně-výstupních úloh najdete v tématu běžné vstupně-výstupní úlohy.For a list of common I/O tasks, see Common I/O Tasks.

Poznámky pro implementátory

Odvozená třída musí minimální implementovat metodu Write(Char), aby mohla být užitečná TextWriter.A derived class must minimally implement the Write(Char) method to make a useful instance of TextWriter.

Konstruktory

TextWriter()

Inicializuje novou instanci třídy TextWriter.Initializes a new instance of the TextWriter class.

TextWriter(IFormatProvider)

Inicializuje novou instanci třídy TextWriter se zadaným poskytovatelem formátu.Initializes a new instance of the TextWriter class with the specified format provider.

Pole

CoreNewLine

Ukládá znaky nového řádku používané pro tento TextWriter.Stores the newline characters used for this TextWriter.

Null

Poskytuje TextWriter bez záložního úložiště, které by bylo možné zapsat do, ale Nečíst z.Provides a TextWriter with no backing store that can be written to, but not read from.

Vlastnosti

Encoding

Při přepsání v odvozené třídě vrátí kódování znaků, ve kterém je výstup napsán.When overridden in a derived class, returns the character encoding in which the output is written.

FormatProvider

Získá objekt, který ovládá formátování.Gets an object that controls formatting.

NewLine

Získá nebo nastaví ukončovací řetězec řádku používaný aktuálním TextWriter.Gets or sets the line terminator string used by the current TextWriter.

Metody

Close()

Zavře aktuální Zapisovač a uvolní všechny systémové prostředky spojené s modulem pro zápis.Closes the current writer and releases any system resources associated with the writer.

CreateObjRef(Type)

Vytvoří objekt, který obsahuje všechny relevantní informace požadované pro vygenerování proxy serveru, který se používá ke komunikaci se vzdáleným objektem.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

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

Uvolní všechny prostředky, které používá objekt TextWriter.Releases all resources used by the TextWriter object.

Dispose(Boolean)

Uvolní nespravované prostředky používané TextWriter a volitelně uvolňuje spravované prostředky.Releases the unmanaged resources used by the TextWriter and optionally releases the managed resources.

DisposeAsync()

Asynchronně uvolňuje všechny prostředky, které používá objekt TextWriter.Asynchronously releases all resources used by the TextWriter object.

Equals(Object)

Určí, zda se zadaný objekt rovná aktuálnímu objektu.Determines whether the specified object is equal to the current object.

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

Vymaže všechny vyrovnávací paměti pro aktuální Zapisovač a způsobí, že všechna data uložená do vyrovnávací paměti se zapisují do základního zařízení.Clears all buffers for the current writer and causes any buffered data to be written to the underlying device.

FlushAsync()

Asynchronně vymaže všechny vyrovnávací paměti pro aktuální Zapisovač a způsobí, že všechna data uložená do vyrovnávací paměti se zapisují do základního zařízení.Asynchronously clears all buffers for the current writer and causes any buffered data to be written to the underlying device.

GetHashCode()

Slouží jako výchozí funkce hash.Serves as the default hash function.

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

Načte aktuální objekt služby životnosti, který řídí zásady životního cyklu pro tuto instanci.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

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

Získá Type aktuální instance.Gets the Type of the current instance.

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

Získá objekt služby životnosti, který řídí zásady životního cyklu pro tuto instanci.Obtains a lifetime service object to control the lifetime policy for this instance.

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

Vytvoří kopii aktuálního Objectbez podstruktury.Creates a shallow copy of the current Object.

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

Vytvoří kopii aktuálního objektu MarshalByRefObject bez podstruktury.Creates a shallow copy of the current MarshalByRefObject object.

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

Vytvoří obálku bezpečnou pro vlákno kolem zadaného TextWriter.Creates a thread-safe wrapper around the specified TextWriter.

ToString()

Vrátí řetězec, který představuje aktuální objekt.Returns a string that represents the current object.

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

Zapíše textovou reprezentaci Boolean hodnoty do textového proudu.Writes the text representation of a Boolean value to the text stream.

Write(Char)

Zapíše znak do textového streamu.Writes a character to the text stream.

Write(Char[])

Zapíše pole znaků do textového proudu.Writes a character array to the text stream.

Write(Char[], Int32, Int32)

Zapisuje podpole znaků do textového proudu.Writes a subarray of characters to the text stream.

Write(Decimal)

Zapíše textovou reprezentaci desítkové hodnoty do textového proudu.Writes the text representation of a decimal value to the text stream.

Write(Double)

Zapíše textovou reprezentaci hodnoty s plovoucí desetinnou čárkou na textový Stream.Writes the text representation of an 8-byte floating-point value to the text stream.

Write(Int32)

Zapíše textovou reprezentaci čísla se znaménkem na 4 bajty do textového proudu.Writes the text representation of a 4-byte signed integer to the text stream.

Write(Int64)

Zapíše textovou reprezentaci čísla se znaménkem na osm bajtů do textového proudu.Writes the text representation of an 8-byte signed integer to the text stream.

Write(Object)

Zapíše textovou reprezentaci objektu do textového proudu voláním metody ToString pro daný objekt.Writes the text representation of an object to the text stream by calling the ToString method on that object.

Write(ReadOnlySpan<Char>)

Zapíše znak span do textového proudu.Writes a character span to the text stream.

Write(Single)

Zapíše textovou reprezentaci hodnoty s plovoucí desetinnou čárkou na textový Stream.Writes the text representation of a 4-byte floating-point value to the text stream.

Write(String)

Zapíše řetězec do textového streamu.Writes a string to the text stream.

Write(String, Object)

Zapíše formátovaný řetězec do textového proudu pomocí stejné sémantiky jako metoda Format(String, Object).Writes a formatted string to the text stream, using the same semantics as the Format(String, Object) method.

Write(String, Object, Object)

Zapíše formátovaný řetězec do textového proudu pomocí stejné sémantiky jako metoda Format(String, Object, Object).Writes a formatted string to the text stream using the same semantics as the Format(String, Object, Object) method.

Write(String, Object, Object, Object)

Zapíše formátovaný řetězec do textového proudu pomocí stejné sémantiky jako metoda Format(String, Object, Object, Object).Writes a formatted string to the text stream, using the same semantics as the Format(String, Object, Object, Object) method.

Write(String, Object[])

Zapíše formátovaný řetězec do textového proudu pomocí stejné sémantiky jako metoda Format(String, Object[]).Writes a formatted string to the text stream, using the same semantics as the Format(String, Object[]) method.

Write(StringBuilder)

Zapíše tvůrce řetězců do textového streamu.Writes a string builder to the text stream.

Write(UInt32)

Zapíše textovou reprezentaci 4 bajtů unsigned integer do textového proudu.Writes the text representation of a 4-byte unsigned integer to the text stream.

Write(UInt64)

Zapíše textovou reprezentaci 8 bajtů unsigned integer do textového proudu.Writes the text representation of an 8-byte unsigned integer to the text stream.

WriteAsync(Char)

Provede asynchronní zápis znaku do textového proudu.Writes a character to the text stream asynchronously.

WriteAsync(Char[])

Provede asynchronní zápis pole znaků do textového proudu.Writes a character array to the text stream asynchronously.

WriteAsync(Char[], Int32, Int32)

Provede asynchronní zápis podpole znaků do textového proudu.Writes a subarray of characters to the text stream asynchronously.

WriteAsync(ReadOnlyMemory<Char>, CancellationToken)

Asynchronně zapisuje do textového streamu velikost znakové oblasti.Asynchronously writes a character memory region to the text stream.

WriteAsync(String)

Provede asynchronní zápis řetězce do textového proudu.Writes a string to the text stream asynchronously.

WriteAsync(StringBuilder, CancellationToken)

Asynchronně zapisuje tvůrce řetězců do textového streamu.Asynchronously writes a string builder to the text stream.

WriteLine()

Zapíše ukončovací znak řádku do textového proudu.Writes a line terminator to the text stream.

WriteLine(Boolean)

Zapíše textovou reprezentaci Boolean hodnoty do textového proudu následovaný ukončovacím znakem řádku.Writes the text representation of a Boolean value to the text stream, followed by a line terminator.

WriteLine(Char)

Zapíše znak do textového proudu následovaný zakončením řádku.Writes a character to the text stream, followed by a line terminator.

WriteLine(Char[])

Zapisuje pole znaků do textového proudu následovaný ukončovacím znakem řádku.Writes an array of characters to the text stream, followed by a line terminator.

WriteLine(Char[], Int32, Int32)

Zapisuje podpole znaků do textového proudu následovaný ukončovacím znakem řádku.Writes a subarray of characters to the text stream, followed by a line terminator.

WriteLine(Decimal)

Zapíše textovou reprezentaci desítkové hodnoty do textového proudu následovaný ukončovacím znakem řádku.Writes the text representation of a decimal value to the text stream, followed by a line terminator.

WriteLine(Double)

Zapisuje textovou reprezentaci hodnoty s plovoucí desetinnou čárkou na textový Stream následovaný zakončením řádku.Writes the text representation of a 8-byte floating-point value to the text stream, followed by a line terminator.

WriteLine(Int32)

Zapíše textovou reprezentaci se čtyřmi čísly se znaménkem na textový Stream následovaný ukončovacím znakem řádku.Writes the text representation of a 4-byte signed integer to the text stream, followed by a line terminator.

WriteLine(Int64)

Zapíše text reprezentující 8bitové celé číslo se znaménkem na textový Stream následovaný ukončovacím znakem řádku.Writes the text representation of an 8-byte signed integer to the text stream, followed by a line terminator.

WriteLine(Object)

Zapíše textovou reprezentaci objektu do textového proudu, a to voláním metody ToString na tomto objektu následovaný ukončovacím znakem řádku.Writes the text representation of an object to the text stream, by calling the ToString method on that object, followed by a line terminator.

WriteLine(ReadOnlySpan<Char>)

Zapíše textovou reprezentaci znakového rozsahu do textového proudu následovaný ukončovacím znakem řádku.Writes the text representation of a character span to the text stream, followed by a line terminator.

WriteLine(Single)

Zapíše textovou reprezentaci hodnoty s plovoucí desetinnou čárkou na textový Stream následovaný zakončením řádku.Writes the text representation of a 4-byte floating-point value to the text stream, followed by a line terminator.

WriteLine(String)

Zapíše řetězec do textového proudu následovaný ukončovacím znakem řádku.Writes a string to the text stream, followed by a line terminator.

WriteLine(String, Object)

Zapíše formátovaný řetězec a nový řádek do textového proudu pomocí stejné sémantiky jako metoda Format(String, Object).Writes a formatted string and a new line to the text stream, using the same semantics as the Format(String, Object) method.

WriteLine(String, Object, Object)

Zapíše formátovaný řetězec a nový řádek do textového proudu pomocí stejné sémantiky jako metoda Format(String, Object, Object).Writes a formatted string and a new line to the text stream, using the same semantics as the Format(String, Object, Object) method.

WriteLine(String, Object, Object, Object)

Zapíše formátovaný řetězec a nový řádek do textového proudu pomocí stejné sémantiky jako Format(String, Object).Writes out a formatted string and a new line to the text stream, using the same semantics as Format(String, Object).

WriteLine(String, Object[])

Zapíše formátovaný řetězec a nový řádek do textového proudu pomocí stejné sémantiky jako Format(String, Object).Writes out a formatted string and a new line to the text stream, using the same semantics as Format(String, Object).

WriteLine(StringBuilder)

Zapíše textovou reprezentaci řetězce tvůrce do textového proudu následovaný ukončovacím znakem řádku.Writes the text representation of a string builder to the text stream, followed by a line terminator.

WriteLine(UInt32)

Zapíše textovou reprezentaci 4 bajtů unsigned integer do textového proudu následovaný ukončovacím znakem řádku.Writes the text representation of a 4-byte unsigned integer to the text stream, followed by a line terminator.

WriteLine(UInt64)

Zapíše textovou reprezentaci 8 bajtů unsigned integer do textového proudu následovaný ukončovacím znakem řádku.Writes the text representation of an 8-byte unsigned integer to the text stream, followed by a line terminator.

WriteLineAsync()

Asynchronně zapisuje ukončovací znak řádku do textového proudu.Asynchronously writes a line terminator to the text stream.

WriteLineAsync(Char)

Asynchronně zapisuje znak do textového streamu následovaný zakončením řádku.Asynchronously writes a character to the text stream, followed by a line terminator.

WriteLineAsync(Char[])

Asynchronně zapisuje pole znaků do textového proudu následovaný ukončovacím znakem řádku.Asynchronously writes an array of characters to the text stream, followed by a line terminator.

WriteLineAsync(Char[], Int32, Int32)

Asynchronně zapisuje podpole znaků do textového proudu následovaný ukončovacím znakem řádku.Asynchronously writes a subarray of characters to the text stream, followed by a line terminator.

WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)

Asynchronně zapisuje textovou reprezentaci znakové oblasti pro znakovou paměť do textového proudu následovaný ukončovacím znakem řádku.Asynchronously writes the text representation of a character memory region to the text stream, followed by a line terminator.

WriteLineAsync(String)

Asynchronně zapíše řetězec do textového proudu následovaný ukončovacím znakem řádku.Asynchronously writes a string to the text stream, followed by a line terminator.

WriteLineAsync(StringBuilder, CancellationToken)

Asynchronně zapisuje textovou reprezentaci tvůrce řetězců do textového proudu následovaný ukončovacím znakem řádku.Asynchronously writes the text representation of a string builder to the text stream, followed by a line terminator.

Explicitní implementace rozhraní

IDisposable.Dispose()

Popis tohoto člena naleznete v tématu Dispose().For a description of this member, see Dispose().

Platí pro

Viz také