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, 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
TextWriter
Dědičnost
Odvozené
Atributy
Implementuje

Příklady

TextWriterTřída 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. StreamWriterTřída 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í WriteLineAsync(String) metody.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 nástroje 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 Write metody, které TextWriter mají primitivní datové 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í TextWriter není vlákno bezpečné.By default, a TextWriter is not thread safe. TextWriter.SynchronizedObálku pro bezpečný přístup z více vláken najdete v tématu.See TextWriter.Synchronized for a thread-safe wrapper.

Důležité

Tento typ implementuje IDisposable rozhraní.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 Dispose metodu 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 (v jazyce C#) 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 IDisposable tématu rozhraní.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í implementaci Write(Char) metody, aby vytvářely užitečnou instanci TextWriter .A derived class must minimally implement the Write(Char) method to make a useful instance of TextWriter.

Konstruktory

TextWriter()

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

TextWriter(IFormatProvider)

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

Pole

CoreNewLine

Slouží k uložení znaků nového řádku TextWriter .Stores the newline characters used for this TextWriter.

Null

Poskytuje TextWriter bez záložního úložiště, které může být zapsáno do, ale nikoli 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, který používá aktuální 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 používané TextWriter objektem.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 používané TextWriter objektem.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í instanci.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 seznamu Object .Creates a shallow copy of the current Object.

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

Vytvoří kopii aktuálního objektu bez podstruktury MarshalByRefObject .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 streamu.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 ToString metody na tento 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 Format(String, Object) metoda.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 Format(String, Object, Object) metoda.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 Format(String, Object, Object, Object) metoda.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 Format(String, Object[]) metoda.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, zavoláním ToString metody na tento objekt 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 Format(String, Object) metoda.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 Format(String, Object, Object) metoda.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().

Metody rozšíření

ConfigureAwait(IAsyncDisposable, Boolean)

Konfiguruje, jak se provádí funkce await u úloh vrácených z asynchronního použití.Configures how awaits on the tasks returned from an async disposable are performed.

Platí pro

Viz také