TextWriter TextWriter TextWriter TextWriter Class

Определение

Представляет модуль записи, который может записывать последовательные наборы символов.Represents a writer that can write a sequential series of characters. Это абстрактный класс.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
Наследование
Производный
Атрибуты
Реализации

Примеры

Класс TextWriter является абстрактным.The TextWriter class is an abstract class. Следовательно, в коде экземпляр этого объекта не создается.Therefore, you do not instantiate it in your code. Класс является производным от TextWriter и предоставляет реализации членов для записи в поток. StreamWriterThe StreamWriter class derives from TextWriter and provides implementations of the members for writing to a stream. В следующем примере показано, как записать две строки, состоящие из строковых значений, в текстовый файл с помощью 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.

Переопределение Dispose в производном классе для предоставления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

Комментарии

TextWriterявляется абстрактным базовым классом StringWriterдля StreamWriter и, который записывает символы в потоки и строки соответственно.TextWriter is the abstract base class of StreamWriter and StringWriter, which write characters to streams and strings, respectively. Создание экземпляра TextWriter для записи объекта в строку, записи строк в файл или сериализации XML.Create an instance of TextWriter to write an object to a string, write strings to a file, or to serialize XML. Кроме того, экземпляр TextWriter можно использовать для записи текста в пользовательское резервное хранилище с помощью тех же интерфейсов API, которые использовались для строки или потока, или для добавления поддержки форматирования текста.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 ВсеTextWriter методы, имеющие примитивные типы данных в качестве параметров, записывают значения в виде строк.All the Write methods of TextWriter having primitive data types as parameters write out the values as strings.

По умолчанию объект TextWriter не является потокобезопасным.By default, a TextWriter is not thread safe. См TextWriter.Synchronized . раздел для потокобезопасной оболочки.See TextWriter.Synchronized for a thread-safe wrapper.

Важно!

Этот тип реализует интерфейс IDisposable.This type implements the IDisposable interface. После завершения использования любого типа, производного от этого типа, следует удалить его прямо или косвенно.When you have finished using any type that derives from this type, you should dispose of it either directly or indirectly. Чтобы сделать это прямо, вызовите его метод Dispose в блоке try/catch.To dispose of the type directly, call its Dispose method in a try/catch block. Чтобы сделать это косвенно, используйте языковые конструкции, такие как using (в C#) или Using (в Visual Basic).To dispose of it indirectly, use a language construct such as using (in C#) or Using (in Visual Basic). Дополнительные сведения см. в IDisposable разделе Dispose и «использование объекта, реализующего IDisposable» раздела Interface.For more information, see Dispose and the "Using an Object that Implements IDisposable" section in the IDisposable interface topic.

Список общих задач ввода-вывода см. в разделе Общие задачи ввода-вывода.For a list of common I/O tasks, see Common I/O Tasks.

Примечания для тех, кто наследует этот метод

Производный класс должен как минимум реализовать Write(Char) метод для создания полезного TextWriterэкземпляра.A derived class must minimally implement the Write(Char) method to make a useful instance of TextWriter.

Конструкторы

TextWriter() TextWriter() TextWriter() TextWriter()

Инициализирует новый экземпляр класса TextWriter.Initializes a new instance of the TextWriter class.

TextWriter(IFormatProvider) TextWriter(IFormatProvider) TextWriter(IFormatProvider) TextWriter(IFormatProvider)

Инициализирует новый экземпляр класса TextWriter указанным поставщиком формата.Initializes a new instance of the TextWriter class with the specified format provider.

Поля

CoreNewLine CoreNewLine CoreNewLine CoreNewLine

Сохраняет символы новой строки, используемые для данного TextWriter.Stores the newline characters used for this TextWriter.

Null Null Null Null

Предоставляет TextWriter без резервного хранилища, в который можно осуществлять запись, но из которого нельзя считывать данные.Provides a TextWriter with no backing store that can be written to, but not read from.

Свойства

Encoding Encoding Encoding Encoding

При переопределении в производном классе возвращает кодировку символов, в которой записаны выходные данные.When overridden in a derived class, returns the character encoding in which the output is written.

FormatProvider FormatProvider FormatProvider FormatProvider

Возвращает объект, управляющий форматированием.Gets an object that controls formatting.

NewLine NewLine NewLine NewLine

Возвращает или задает признак конца строки, используемой текущим TextWriter.Gets or sets the line terminator string used by the current TextWriter.

Методы

Close() Close() Close() Close()

Закрывает текущий модуль записи и освобождает все системные ресурсы, связанные с ним.Closes the current writer and releases any system resources associated with the writer.

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

Создает объект, который содержит всю необходимую информацию для создания прокси-сервера, используемого для взаимодействия с удаленным объектом.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
Dispose() Dispose() Dispose() Dispose()

Освобождает все ресурсы, используемые объектом TextWriter.Releases all resources used by the TextWriter object.

Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Освобождает неуправляемые ресурсы, используемые объектом TextWriter, а при необходимости освобождает также управляемые ресурсы.Releases the unmanaged resources used by the TextWriter and optionally releases the managed resources.

DisposeAsync() DisposeAsync() DisposeAsync() DisposeAsync()

Асинхронно освобождает все ресурсы, используемые объектом TextWriter.Asynchronously releases all resources used by the TextWriter object.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Inherited from Object)
Flush() Flush() Flush() Flush()

Очищает все буферы текущего модуля записи и вызывает немедленную запись всех буферизованных данных на базовое устройство.Clears all buffers for the current writer and causes any buffered data to be written to the underlying device.

FlushAsync() FlushAsync() FlushAsync() FlushAsync()

Асинхронно очищает все буферы текущего средства записи и вызывает запись всех буферизованных данных в базовое устройство.Asynchronously clears all buffers for the current writer and causes any buffered data to be written to the underlying device.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

Извлекает объект обслуживания во время существования, который управляет политикой времени существования данного экземпляра.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetType() GetType() GetType() GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

Получает объект службы времени существования для управления политикой времени существования для этого экземпляра.Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

Создает неполную копию текущего объекта MarshalByRefObject.Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
Synchronized(TextWriter) Synchronized(TextWriter) Synchronized(TextWriter) Synchronized(TextWriter)

Создает потокобезопасную оболочку для указанного объекта TextWriter.Creates a thread-safe wrapper around the specified TextWriter.

ToString() ToString() ToString() ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Inherited from Object)
Write(Boolean) Write(Boolean) Write(Boolean) Write(Boolean)

Записывает текстовое представление значения типа Boolean в текстовый поток.Writes the text representation of a Boolean value to the text stream.

Write(Char) Write(Char) Write(Char) Write(Char)

Записывает символ в текстовый поток.Writes a character to the text stream.

Write(Char[]) Write(Char[]) Write(Char[]) Write(Char[])

Записывает массив символов в текстовый поток.Writes a character array to the text stream.

Write(Char[], Int32, Int32) Write(Char[], Int32, Int32) Write(Char[], Int32, Int32) Write(Char[], Int32, Int32)

Записывает подмассив символов в текстовый поток.Writes a subarray of characters to the text stream.

Write(Decimal) Write(Decimal) Write(Decimal) Write(Decimal)

Записывает текстовое представление десятичного значения в текстовый поток.Writes the text representation of a decimal value to the text stream.

Write(Double) Write(Double) Write(Double) Write(Double)

Записывает в текстовый поток текстовое представление значения с плавающей запятой размером 8 байт.Writes the text representation of an 8-byte floating-point value to the text stream.

Write(Int32) Write(Int32) Write(Int32) Write(Int32)

Записывает в текстовый поток текстовое представление целого числа со знаком размером 4 байта.Writes the text representation of a 4-byte signed integer to the text stream.

Write(Int64) Write(Int64) Write(Int64) Write(Int64)

Записывает в текстовый поток текстовое представление целого числа со знаком размером 8 байт.Writes the text representation of an 8-byte signed integer to the text stream.

Write(Object) Write(Object) Write(Object) Write(Object)

Записывает в текстовый поток текстовое представление объекта с помощью вызова метода ToString для этого объекта.Writes the text representation of an object to the text stream by calling the ToString method on that object.

Write(ReadOnlySpan<Char>) Write(ReadOnlySpan<Char>) Write(ReadOnlySpan<Char>) Write(ReadOnlySpan<Char>)

Записывает диапазон символов в текстовый поток.Writes a character span to the text stream.

Write(Single) Write(Single) Write(Single) Write(Single)

Записывает в текстовый поток текстовое представление значения с плавающей запятой размером 4 байта.Writes the text representation of a 4-byte floating-point value to the text stream.

Write(String) Write(String) Write(String) Write(String)

Асинхронно записывает строку в текстовый поток.Writes a string to the text stream.

Write(String, Object) Write(String, Object) Write(String, Object) Write(String, Object)

Записывает форматированную строку в текстовый поток, используя ту же семантику, что и метод 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) Write(String, Object, Object) Write(String, Object, Object) Write(String, Object, Object)

Записывает форматированную строку в текстовый поток, используя ту же семантику, что и метод 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) Write(String, Object, Object, Object) Write(String, Object, Object, Object) Write(String, Object, Object, Object)

Записывает форматированную строку в текстовый поток, используя ту же семантику, что и метод 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[]) Write(String, Object[]) Write(String, Object[]) Write(String, Object[])

Записывает форматированную строку в текстовый поток, используя ту же семантику, что и метод Format(String, Object[]).Writes a formatted string to the text stream, using the same semantics as the Format(String, Object[]) method.

Write(StringBuilder) Write(StringBuilder) Write(StringBuilder) Write(StringBuilder)

Записывает построитель строки в текстовый поток.Writes a string builder to the text stream.

Write(UInt32) Write(UInt32) Write(UInt32) Write(UInt32)

Записывает в текстовый поток текстовое представление целого числа без знака размером 4 байта.Writes the text representation of a 4-byte unsigned integer to the text stream.

Write(UInt64) Write(UInt64) Write(UInt64) Write(UInt64)

Записывает в текстовый поток текстовое представление целого числа без знака размером 8 байт.Writes the text representation of an 8-byte unsigned integer to the text stream.

WriteAsync(Char) WriteAsync(Char) WriteAsync(Char) WriteAsync(Char)

Выполняет асинхронную запись символа в текстовый поток.Writes a character to the text stream asynchronously.

WriteAsync(Char[]) WriteAsync(Char[]) WriteAsync(Char[]) WriteAsync(Char[])

Выполняет асинхронную запись массива символов в текстовый поток.Writes a character array to the text stream asynchronously.

WriteAsync(Char[], Int32, Int32) WriteAsync(Char[], Int32, Int32) WriteAsync(Char[], Int32, Int32) WriteAsync(Char[], Int32, Int32)

Асинхронно записывает подмассив символов в текстовый поток.Writes a subarray of characters to the text stream asynchronously.

WriteAsync(ReadOnlyMemory<Char>, CancellationToken) WriteAsync(ReadOnlyMemory<Char>, CancellationToken) WriteAsync(ReadOnlyMemory<Char>, CancellationToken) WriteAsync(ReadOnlyMemory<Char>, CancellationToken)

Выполняет асинхронную запись области памяти символов в текстовый поток.Asynchronously writes a character memory region to the text stream.

WriteAsync(String) WriteAsync(String) WriteAsync(String) WriteAsync(String)

Выполняет асинхронную запись строки в текстовый поток.Writes a string to the text stream asynchronously.

WriteAsync(StringBuilder, CancellationToken) WriteAsync(StringBuilder, CancellationToken) WriteAsync(StringBuilder, CancellationToken) WriteAsync(StringBuilder, CancellationToken)

Асинхронно записывает построитель строки в текстовый поток.Asynchronously writes a string builder to the text stream.

WriteLine() WriteLine() WriteLine() WriteLine()

Записывает признак конца строки в текстовый поток.Writes a line terminator to the text stream.

WriteLine(Boolean) WriteLine(Boolean) WriteLine(Boolean) WriteLine(Boolean)

Записывает в текстовый поток текстовое представление значения типа Boolean, за которым следует знак конца строки.Writes the text representation of a Boolean value to the text stream, followed by a line terminator.

WriteLine(Char) WriteLine(Char) WriteLine(Char) WriteLine(Char)

Записывает в текстовый поток символ, за которым следует признак конца строки.Writes a character to the text stream, followed by a line terminator.

WriteLine(Char[]) WriteLine(Char[]) WriteLine(Char[]) WriteLine(Char[])

Записывает в текстовый поток массив символов, за которыми следует признак конца строки.Writes an array of characters to the text stream, followed by a line terminator.

WriteLine(Char[], Int32, Int32) WriteLine(Char[], Int32, Int32) WriteLine(Char[], Int32, Int32) WriteLine(Char[], Int32, Int32)

Записывает в текстовый поток подмассив символов, за которым следует признак конца строки.Writes a subarray of characters to the text stream, followed by a line terminator.

WriteLine(Decimal) WriteLine(Decimal) WriteLine(Decimal) WriteLine(Decimal)

Записывает в текстовый поток текстовое представление десятичного значения, за которым следует знак конца строки.Writes the text representation of a decimal value to the text stream, followed by a line terminator.

WriteLine(Double) WriteLine(Double) WriteLine(Double) WriteLine(Double)

Записывает в текстовый поток текстовое представление значения с плавающей запятой размером 8 байт, за которым следует признак конца строки.Writes the text representation of a 8-byte floating-point value to the text stream, followed by a line terminator.

WriteLine(Int32) WriteLine(Int32) WriteLine(Int32) WriteLine(Int32)

Записывает в текстовый поток текстовое представление целого числа со знаком размером 4 байта, за которым следует признак конца строки.Writes the text representation of a 4-byte signed integer to the text stream, followed by a line terminator.

WriteLine(Int64) WriteLine(Int64) WriteLine(Int64) WriteLine(Int64)

Записывает в текстовый поток текстовое представление целого числа со знаком размером 8 байт, за которым следует признак конца строки.Writes the text representation of an 8-byte signed integer to the text stream, followed by a line terminator.

WriteLine(Object) WriteLine(Object) WriteLine(Object) WriteLine(Object)

Записывает в текстовый поток текстовое представление объекта путем вызова метода ToString для этого объекта, за которым следует признак конца строки.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>) WriteLine(ReadOnlySpan<Char>) WriteLine(ReadOnlySpan<Char>) WriteLine(ReadOnlySpan<Char>)

Записывает в текстовый поток текстовое представление диапазона символов, за которым следует знак конца строки.Writes the text representation of a character span to the text stream, followed by a line terminator.

WriteLine(Single) WriteLine(Single) WriteLine(Single) WriteLine(Single)

Записывает в текстовый поток текстовое представление значения с плавающей запятой размером 4 байта, за которым следует признак конца строки.Writes the text representation of a 4-byte floating-point value to the text stream, followed by a line terminator.

WriteLine(String) WriteLine(String) WriteLine(String) WriteLine(String)

Записывает в текстовый поток строку, за которой следует признак конца строки.Writes a string to the text stream, followed by a line terminator.

WriteLine(String, Object) WriteLine(String, Object) WriteLine(String, Object) WriteLine(String, Object)

Записывает форматированную строку и перенос строки в текстовый поток, используя ту же семантику, что и метод 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) WriteLine(String, Object, Object) WriteLine(String, Object, Object) WriteLine(String, Object, Object)

Записывает форматированную строку и перенос строки в текстовый поток, используя ту же семантику, что и метод 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) WriteLine(String, Object, Object, Object) WriteLine(String, Object, Object, Object) WriteLine(String, Object, Object, Object)

Записывает форматированную строку и перенос строки в текстовый поток, используя ту же семантику, что и 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[]) WriteLine(String, Object[]) WriteLine(String, Object[]) WriteLine(String, Object[])

Записывает форматированную строку и перенос строки в текстовый поток, используя ту же семантику, что и 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) WriteLine(StringBuilder) WriteLine(StringBuilder) WriteLine(StringBuilder)

Записывает в текстовый поток текстовое представление построителя строки, за которым следует знак конца строки.Writes the text representation of a string builder to the text stream, followed by a line terminator.

WriteLine(UInt32) WriteLine(UInt32) WriteLine(UInt32) WriteLine(UInt32)

Записывает в текстовый поток текстовое представление целого числа без знака размером 4 байта, за которым следует признак конца строки.Writes the text representation of a 4-byte unsigned integer to the text stream, followed by a line terminator.

WriteLine(UInt64) WriteLine(UInt64) WriteLine(UInt64) WriteLine(UInt64)

Записывает в текстовый поток текстовое представление целого числа без знака размером 8 байт, за которым следует признак конца строки.Writes the text representation of an 8-byte unsigned integer to the text stream, followed by a line terminator.

WriteLineAsync() WriteLineAsync() WriteLineAsync() WriteLineAsync()

Асинхронно записывает признак конца строки в текстовый поток.Asynchronously writes a line terminator to the text stream.

WriteLineAsync(Char) WriteLineAsync(Char) WriteLineAsync(Char) WriteLineAsync(Char)

Асинхронно записывает в текстовый поток символ, за которым следует признак конца строки.Asynchronously writes a character to the text stream, followed by a line terminator.

WriteLineAsync(Char[]) WriteLineAsync(Char[]) WriteLineAsync(Char[]) WriteLineAsync(Char[])

Асинхронно записывает в текстовый поток массив символов, за которым следует признак конца строки.Asynchronously writes an array of characters to the text stream, followed by a line terminator.

WriteLineAsync(Char[], Int32, Int32) WriteLineAsync(Char[], Int32, Int32) WriteLineAsync(Char[], Int32, Int32) WriteLineAsync(Char[], Int32, Int32)

Асинхронно записывает в текстовый поток подмассив символов, за которым следует признак конца строки.Asynchronously writes a subarray of characters to the text stream, followed by a line terminator.

WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken) WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken) WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken) WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)

Асинхронно записывает в текстовый поток текстовое представление области памяти символов, за которым следует знак конца строки.Asynchronously writes the text representation of a character memory region to the text stream, followed by a line terminator.

WriteLineAsync(String) WriteLineAsync(String) WriteLineAsync(String) WriteLineAsync(String)

Асинхронно записывает в текстовый поток строку, за которой следует признак конца строки.Asynchronously writes a string to the text stream, followed by a line terminator.

WriteLineAsync(StringBuilder, CancellationToken) WriteLineAsync(StringBuilder, CancellationToken) WriteLineAsync(StringBuilder, CancellationToken) WriteLineAsync(StringBuilder, CancellationToken)

Асинхронно записывает в текстовый поток текстовое представление построителя строки, за которым следует знак конца строки.Asynchronously writes the text representation of a string builder to the text stream, followed by a line terminator.

Явные реализации интерфейса

IDisposable.Dispose() IDisposable.Dispose() IDisposable.Dispose() IDisposable.Dispose()

Описание этого члена см. в разделе Dispose().For a description of this member, see Dispose().

Применяется к

Дополнительно