TextWriter Klasa

Definicja

Reprezentuje składnik zapisywania, który może napisać sekwencyjne serie znaków.Represents a writer that can write a sequential series of characters. Ta klasa jest abstrakcyjna.This class is abstract.

public ref class TextWriter abstract : MarshalByRefObject, IDisposable
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public abstract class TextWriter : MarshalByRefObject, IDisposable
type TextWriter = class
    inherit MarshalByRefObject
    interface IDisposable
Public MustInherit Class TextWriter
Inherits MarshalByRefObject
Implements IDisposable
Dziedziczenie
Pochodne
Atrybuty
Implementuje

Przykłady

TextWriter Klasa jest klasą abstrakcyjną.The TextWriter class is an abstract class. W związku z tym, nie tworzy się obiektu w kodzie.Therefore, you do not instantiate it in your code. Klasa pochodzi od TextWriter i zapewnia implementacje elementów członkowskich do zapisu w strumieniu. StreamWriterThe StreamWriter class derives from TextWriter and provides implementations of the members for writing to a stream. Poniższy przykład pokazuje, jak napisać dwa wiersze, które składają się z wartości ciągu do pliku tekstowego za 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.

Zastąp metodę Dispose w klasie pochodnej w celu zapewnieniaOverride 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

Uwagi

TextWriterjest abstrakcyjną klasą StreamWriter bazową StringWriteri, która zapisuje znaki odpowiednio do strumieni i ciągów.TextWriter is the abstract base class of StreamWriter and StringWriter, which write characters to streams and strings, respectively. Utwórz wystąpienie TextWriter , aby napisać obiekt do ciągu, napisać ciągi do pliku lub serializować XML.Create an instance of TextWriter to write an object to a string, write strings to a file, or to serialize XML. Można również użyć wystąpienia programu TextWriter w celu zapisania tekstu do niestandardowego magazynu zapasowego przy użyciu tych samych interfejsów API, które będą używane dla ciągu lub strumienia, lub w celu dodania obsługi formatowania tekstu.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.

Write WszystkieTextWriter metody mające typy danych pierwotnych jako parametry zapisują wartości jako ciągi.All the Write methods of TextWriter having primitive data types as parameters write out the values as strings.

Domyślnie TextWriter nie jest to wątek bezpieczny.By default, a TextWriter is not thread safe. Zobacz TextWriter.Synchronized , aby znaleźć bezpieczny wątkowo otokę.See TextWriter.Synchronized for a thread-safe wrapper.

Ważne

Ten typ implementuje IDisposable interfejs.This type implements the IDisposable interface. Po zakończeniu korzystania z dowolnego typu, który pochodzi z tego typu, należy usunąć go bezpośrednio lub pośrednio.When you have finished using any type that derives from this type, you should dispose of it either directly or indirectly. Aby usunąć typ bezpośrednio Dispose , wywołaj jego metodę try / catch w bloku.To dispose of the type directly, call its Dispose method in a try/catch block. Aby usunąć go pośrednio, użyj konstrukcji języka, takiej jak using (in C#) lub Using (w Visual Basic).To dispose of it indirectly, use a language construct such as using (in C#) or Using (in Visual Basic). Aby uzyskać więcej informacji, zobacz sekcję Dispose i "Używanie obiektu implementującego IDisposable interfejs IDisposable" w temacie dotyczącym interfejsu.For more information, see Dispose and the "Using an Object that Implements IDisposable" section in the IDisposable interface topic.

Aby uzyskać listę typowych zadań we/wy, zobacz typowe zadania we/wy.For a list of common I/O tasks, see Common I/O Tasks.

Uwagi dotyczące implementowania

Klasa pochodna musi być minimalnym wdrożeniem Write(Char) metody w celu udostępnienia użytecznego TextWriterwystąpienia.A derived class must minimally implement the Write(Char) method to make a useful instance of TextWriter.

Konstruktory

TextWriter()

Inicjuje nowe wystąpienie klasy TextWriter klasy.Initializes a new instance of the TextWriter class.

TextWriter(IFormatProvider)

Inicjuje nowe wystąpienie TextWriter klasy z określonym dostawcą formatu.Initializes a new instance of the TextWriter class with the specified format provider.

Pola

CoreNewLine

Przechowuje znaki nowego wiersza używane dla tego TextWriterelementu.Stores the newline characters used for this TextWriter.

Null

TextWriter Program udostępnia bez magazynu zapasowego, w którym można zapisywać, ale nie czytać z programu.Provides a TextWriter with no backing store that can be written to, but not read from.

Właściwości

Encoding

Gdy jest zastępowany w klasie pochodnej, zwraca kodowanie znaków, w którym napisano dane wyjściowe.When overridden in a derived class, returns the character encoding in which the output is written.

FormatProvider

Pobiera obiekt, który kontroluje formatowanie.Gets an object that controls formatting.

NewLine

Pobiera lub ustawia ciąg terminatora wiersza używany przez bieżący TextWriter.Gets or sets the line terminator string used by the current TextWriter.

Metody

Close()

Zamyka bieżący składnik zapisywania i zwalnia wszystkie zasoby systemowe skojarzone z modułem zapisywania.Closes the current writer and releases any system resources associated with the writer.

CreateObjRef(Type)

Tworzy obiekt, który zawiera wszystkie istotne informacje wymagane do wygenerowania serwera proxy używanego do komunikacji z obiektem zdalnym.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Odziedziczone po MarshalByRefObject)
Dispose()

Zwalnia wszystkie zasoby używane przez TextWriter obiekt.Releases all resources used by the TextWriter object.

Dispose(Boolean)

Zwalnia niezarządzane zasoby używane przez TextWriter program i opcjonalnie zwalnia zarządzane zasoby.Releases the unmanaged resources used by the TextWriter and optionally releases the managed resources.

DisposeAsync()

Asynchronicznie zwalnia wszystkie zasoby używane przez TextWriter obiekt.Asynchronously releases all resources used by the TextWriter object.

Equals(Object)

Określa, czy określony obiekt jest równy bieżącemu obiektowi.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
Flush()

Czyści wszystkie bufory dla bieżącego składnika zapisywania i powoduje, że wszystkie buforowane dane są zapisywane na podstawowym urządzeniu.Clears all buffers for the current writer and causes any buffered data to be written to the underlying device.

FlushAsync()

Asynchronicznie czyści wszystkie bufory dla bieżącego składnika zapisywania i powoduje, że wszystkie buforowane dane są zapisywane na podstawowym urządzeniu.Asynchronously clears all buffers for the current writer and causes any buffered data to be written to the underlying device.

GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Odziedziczone po Object)
GetLifetimeService()

Pobiera bieżący obiekt usługi okresu istnienia, który kontroluje zasady okresu istnienia dla tego wystąpienia.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Odziedziczone po MarshalByRefObject)
GetType()

Pobiera Type bieżącego wystąpienia.Gets the Type of the current instance.

(Odziedziczone po Object)
InitializeLifetimeService()

Uzyskuje obiekt usługi istnienia w celu kontrolowania zasad okresu istnienia dla tego wystąpienia.Obtains a lifetime service object to control the lifetime policy for this instance.

(Odziedziczone po MarshalByRefObject)
MemberwiseClone()

Tworzy skróconą kopię bieżącego Object.Creates a shallow copy of the current Object.

(Odziedziczone po Object)
MemberwiseClone(Boolean)

Tworzy skróconą kopię bieżącego MarshalByRefObject obiektu.Creates a shallow copy of the current MarshalByRefObject object.

(Odziedziczone po MarshalByRefObject)
Synchronized(TextWriter)

Tworzy otokę bezpieczną wątkową wokół określonego TextWriter.Creates a thread-safe wrapper around the specified TextWriter.

ToString()

Zwraca ciąg, który reprezentuje bieżący obiekt.Returns a string that represents the current object.

(Odziedziczone po Object)
Write(Boolean)

Zapisuje tekstową reprezentację Boolean wartości do strumienia tekstu.Writes the text representation of a Boolean value to the text stream.

Write(Char)

Zapisuje znak w strumieniu tekstowym.Writes a character to the text stream.

Write(Char[])

Zapisuje tablicę znaków w strumieniu tekstowym.Writes a character array to the text stream.

Write(Char[], Int32, Int32)

Zapisuje podtablicę znaków do strumienia tekstu.Writes a subarray of characters to the text stream.

Write(Decimal)

Zapisuje tekstową reprezentację wartości dziesiętnej w strumieniu tekstowym.Writes the text representation of a decimal value to the text stream.

Write(Double)

Zapisuje tekstową reprezentację 8-bajtowej wartości zmiennoprzecinkowej w strumieniu tekstowym.Writes the text representation of an 8-byte floating-point value to the text stream.

Write(Int32)

Zapisuje tekstową reprezentację wartości 4-bajtowej ze znakiem w strumieniu tekstowym.Writes the text representation of a 4-byte signed integer to the text stream.

Write(Int64)

Zapisuje tekstową reprezentację 8-bajtowej liczby całkowitej ze znakiem do strumienia tekstu.Writes the text representation of an 8-byte signed integer to the text stream.

Write(Object)

Zapisuje tekstową reprezentację obiektu do strumienia tekstowego, wywołując ToString metodę dla tego obiektu.Writes the text representation of an object to the text stream by calling the ToString method on that object.

Write(ReadOnlySpan<Char>)

Zapisuje zakres znaków w strumieniu tekstowym.Writes a character span to the text stream.

Write(Single)

Zapisuje tekstową reprezentację wartości 4-bajtowej zmiennoprzecinkowej w strumieniu tekstowym.Writes the text representation of a 4-byte floating-point value to the text stream.

Write(String)

Zapisuje ciąg w strumieniu tekstowym.Writes a string to the text stream.

Write(String, Object)

Zapisuje sformatowany ciąg w strumieniu tekstowym, używając tej samej semantyki co 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)

Zapisuje sformatowany ciąg w strumieniu tekstowym przy użyciu tej samej semantyki co 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)

Zapisuje sformatowany ciąg w strumieniu tekstowym, używając tej samej semantyki co 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[])

Zapisuje sformatowany ciąg w strumieniu tekstowym, używając tej samej semantyki co Format(String, Object[]) Metoda.Writes a formatted string to the text stream, using the same semantics as the Format(String, Object[]) method.

Write(StringBuilder)

Zapisuje konstruktora ciągów do strumienia tekstu.Writes a string builder to the text stream.

Write(UInt32)

Zapisuje tekstową reprezentację wartości 4-bajtowej bez znaku do strumienia tekstu.Writes the text representation of a 4-byte unsigned integer to the text stream.

Write(UInt64)

Zapisuje tekstową reprezentację 8-bajtowej liczby całkowitej bez znaku do strumienia tekstu.Writes the text representation of an 8-byte unsigned integer to the text stream.

WriteAsync(Char)

Zapisuje znak w strumieniu tekstowym asynchronicznie.Writes a character to the text stream asynchronously.

WriteAsync(Char[])

Zapisuje tablicę znaków w strumieniu tekstowym asynchronicznie.Writes a character array to the text stream asynchronously.

WriteAsync(Char[], Int32, Int32)

Zapisuje podtablicę znaków w strumieniu tekstowym asynchronicznie.Writes a subarray of characters to the text stream asynchronously.

WriteAsync(ReadOnlyMemory<Char>, CancellationToken)

Asynchronicznie zapisuje region pamięci znaku w strumieniu tekstowym.Asynchronously writes a character memory region to the text stream.

WriteAsync(String)

Zapisuje ciąg w strumieniu tekstowym asynchronicznie.Writes a string to the text stream asynchronously.

WriteAsync(StringBuilder, CancellationToken)

Asynchronicznie zapisuje konstruktora ciągów do strumienia tekstu.Asynchronously writes a string builder to the text stream.

WriteLine()

Zapisuje terminator wiersza w strumieniu tekstowym.Writes a line terminator to the text stream.

WriteLine(Boolean)

Zapisuje tekstową reprezentację Boolean wartości w strumieniu tekstowym, po której następuje terminator wiersza.Writes the text representation of a Boolean value to the text stream, followed by a line terminator.

WriteLine(Char)

Zapisuje znak w strumieniu tekstowym, po którym następuje terminator wiersza.Writes a character to the text stream, followed by a line terminator.

WriteLine(Char[])

Zapisuje tablicę znaków w strumieniu tekstowym, po której następuje terminator wiersza.Writes an array of characters to the text stream, followed by a line terminator.

WriteLine(Char[], Int32, Int32)

Zapisuje podtablicę znaków w strumieniu tekstowym, po którym następuje terminator wiersza.Writes a subarray of characters to the text stream, followed by a line terminator.

WriteLine(Decimal)

Zapisuje tekstową reprezentację wartości dziesiętnej w strumieniu tekstowym, po której następuje terminator wiersza.Writes the text representation of a decimal value to the text stream, followed by a line terminator.

WriteLine(Double)

Zapisuje tekstową reprezentację 8-bajtowej wartości zmiennoprzecinkowej w strumieniu tekstowym, po której następuje terminator wiersza.Writes the text representation of a 8-byte floating-point value to the text stream, followed by a line terminator.

WriteLine(Int32)

Zapisuje tekstową reprezentację wartości 4-bajtowej ze znakiem w strumieniu tekstowym, po której następuje terminator wiersza.Writes the text representation of a 4-byte signed integer to the text stream, followed by a line terminator.

WriteLine(Int64)

Zapisuje tekstową reprezentację 8-bajtowej liczby całkowitej ze znakiem do strumienia tekstowego, a po niej terminator wiersza.Writes the text representation of an 8-byte signed integer to the text stream, followed by a line terminator.

WriteLine(Object)

Zapisuje tekstową reprezentację obiektu do strumienia tekstowego, wywołując ToString metodę dla tego obiektu, a następnie terminator wiersza.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>)

Zapisuje tekstową reprezentację zakresu znaków w strumieniu tekstowym, po którym następuje terminator wiersza.Writes the text representation of a character span to the text stream, followed by a line terminator.

WriteLine(Single)

Zapisuje tekstową reprezentację wartości zmiennoprzecinkowej 4-bajtowej do strumienia tekstu, po którym następuje terminator wiersza.Writes the text representation of a 4-byte floating-point value to the text stream, followed by a line terminator.

WriteLine(String)

Zapisuje ciąg w strumieniu tekstowym, po którym następuje terminator wiersza.Writes a string to the text stream, followed by a line terminator.

WriteLine(String, Object)

Zapisuje sformatowany ciąg i nowy wiersz do strumienia tekstowego przy użyciu tej samej semantyki co 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)

Zapisuje sformatowany ciąg i nowy wiersz do strumienia tekstowego przy użyciu tej samej semantyki co 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)

Zapisuje sformatowany ciąg i nowy wiersz do strumienia tekstowego przy użyciu tej samej semantyki co 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[])

Zapisuje sformatowany ciąg i nowy wiersz do strumienia tekstowego przy użyciu tej samej semantyki co 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)

Zapisuje tekstową reprezentację konstruktora ciągów do strumienia tekstu, po którym następuje terminator wiersza.Writes the text representation of a string builder to the text stream, followed by a line terminator.

WriteLine(UInt32)

Zapisuje tekstową reprezentację z 4-bajtową liczbą całkowitą bez znaku do strumienia tekstowego, po którym następuje terminator wiersza.Writes the text representation of a 4-byte unsigned integer to the text stream, followed by a line terminator.

WriteLine(UInt64)

Zapisuje tekstową reprezentację 8-bajtowej liczby całkowitej bez znaku do strumienia tekstowego, a po niej terminator wiersza.Writes the text representation of an 8-byte unsigned integer to the text stream, followed by a line terminator.

WriteLineAsync()

Asynchronicznie zapisuje terminator wiersza w strumieniu tekstowym.Asynchronously writes a line terminator to the text stream.

WriteLineAsync(Char)

Asynchronicznie zapisuje znak w strumieniu tekstowym, po którym następuje terminator wiersza.Asynchronously writes a character to the text stream, followed by a line terminator.

WriteLineAsync(Char[])

Asynchronicznie zapisuje tablicę znaków w strumieniu tekstowym, po którym następuje terminator wiersza.Asynchronously writes an array of characters to the text stream, followed by a line terminator.

WriteLineAsync(Char[], Int32, Int32)

Asynchronicznie zapisuje podtablicę znaków do strumienia tekstu, po którym następuje terminator wiersza.Asynchronously writes a subarray of characters to the text stream, followed by a line terminator.

WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)

Asynchronicznie zapisuje tekstową reprezentację regionu pamięci znaku do strumienia tekstu, po którym następuje terminator wiersza.Asynchronously writes the text representation of a character memory region to the text stream, followed by a line terminator.

WriteLineAsync(String)

Asynchronicznie zapisuje ciąg w strumieniu tekstowym, po którym następuje terminator wiersza.Asynchronously writes a string to the text stream, followed by a line terminator.

WriteLineAsync(StringBuilder, CancellationToken)

Asynchronicznie zapisuje tekstową reprezentację konstruktora ciągów do strumienia tekstu, po którym następuje terminator wiersza.Asynchronously writes the text representation of a string builder to the text stream, followed by a line terminator.

Jawne implementacje interfejsu

IDisposable.Dispose()

Aby uzyskać opis tego elementu członkowskiego, Dispose()Zobacz.For a description of this member, see Dispose().

Dotyczy

Zobacz też