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. StreamWriter Класс является производным от TextWriter и предоставляет реализацию членов для записи в поток.The 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.

Переопределение в производном классе для предоставления DisposeOverride 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 является абстрактным базовым классом для StreamWriter и StringWriter, что запись символов потоков и строк, соответственно.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). Дополнительные сведения см. в разделе Dispose и в разделе «С помощью объекта, реализует IDisposable» IDisposable разделу интерфейса.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()
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 string or stream.

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

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

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

Выполняет запись массива символов в текстовую строку или поток.Writes a character array to the text string or 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 string or stream.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Выполняет асинхронную запись массива символов в текстовую строку или поток.Writes a character array to the text string or 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 string or stream asynchronously.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Записывает в текстовую строку или поток текстовое представление объекта путем вызова метода ToString для этого объекта, за которым следует признак конца строки.Writes the text representation of an object by calling the ToString method on that object, followed by a line terminator to the text string or stream.

WriteLine(ReadOnlySpan<Char>) WriteLine(ReadOnlySpan<Char>) WriteLine(ReadOnlySpan<Char>) WriteLine(ReadOnlySpan<Char>)
WriteLine(Single) WriteLine(Single) WriteLine(Single) WriteLine(Single)

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

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

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

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 string or 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 string or 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, 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, using the same semantics as Format(String, Object).

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

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

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

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

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

Асинхронно записывает признак конца строки в текстовую строку или поток.Writes a line terminator asynchronously to the text string or stream.

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

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

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

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

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

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

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

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

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

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

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

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

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

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