TextWriter.Write Метод

Определение

Пространство имен:

System.IO

Сборка:

System.Runtime.dll

Записывает данные в текстовый поток.

Перегрузки

Write(String, Object, Object, Object)	Записывает форматированную строку в текстовый поток, используя ту же семантику, что и метод Format(String, Object, Object, Object).
Write(Char[], Int32, Int32)	Записывает вложенные символы в текстовый поток.
Write(String, Object[])	Записывает форматированную строку в текстовый поток, используя ту же семантику, что и метод Format(String, Object[]).
Write(String, Object)	Записывает форматированную строку в текстовый поток, используя ту же семантику, что и метод Format(String, Object).
Write(UInt64)	Записывает текстовое представление 8-байтового целого числа без знака в текстовый поток.
Write(UInt32)	Записывает текстовое представление 4-байтового целого числа без знака в текстовый поток.
Write(StringBuilder)	Записывает построитель строк в текстовый поток.
Write(String)	Записывает строку в текстовый поток.
Write(Single)	Записывает текстовое представление 4-байтового значения с плавающей запятой в текстовый поток.
Write(String, Object, Object)	Записывает форматированную строку в текстовый поток, используя ту же семантику, что и метод Format(String, Object, Object).
Write(Object)	Записывает текстовое представление объекта в текстовый поток, вызвав метод ToString для этого объекта.
Write(Int64)	Записывает текстовое представление 8-байтового целого числа со знаком в текстовый поток.
Write(Int32)	Записывает текстовое представление 4-байтового целого числа со знаком в текстовый поток.
Write(Double)	Записывает текстовое представление 8-байтового значения с плавающей запятой в текстовый поток.
Write(Decimal)	Записывает текстовое представление десятичного значения в текстовый поток.
Write(Char[])	Записывает массив символов в текстовый поток.
Write(Char)	Записывает символ в текстовый поток.
Write(Boolean)	Записывает текстовое представление значения Boolean в текстовый поток.
Write(ReadOnlySpan<Char>)	Записывает диапазон символов в текстовый поток.

Write(String, Object, Object, Object)

Исходный код:

TextWriter.cs

Записывает форматированную строку в текстовый поток, используя ту же семантику, что и метод Format(String, Object, Object, Object).

public:
 virtual void Write(System::String ^ format, System::Object ^ arg0, System::Object ^ arg1, System::Object ^ arg2);

public virtual void Write (string format, object? arg0, object? arg1, object? arg2);

abstract member Write : string * obj * obj * obj -> unit
override this.Write : string * obj * obj * obj -> unit

Public Overridable Sub Write (format As String, arg0 As Object, arg1 As Object, arg2 As Object)

Параметры

format

String

Строка составного формата.

arg0

Object

Первый объект для форматирования и записи.

arg1

Object

Второй объект для форматирования и записи.

arg2

Object

Третий объект для форматирования и записи.

Исключения

ArgumentNullException

format null.

ObjectDisposedException

TextWriter закрыт.

IOException

Возникает ошибка ввода-вывода.

FormatException

format не является допустимой строкой составного формата.

-или-

Индекс элемента форматирования меньше 0 (ноль) или больше или равен числу объектов, отформатированных (для перегрузки этого метода — три).

Комментарии

Этот метод использует составное форматирование для преобразования значения объекта в строковое представление и внедрения этого представления в строку. .NET предоставляет обширную поддержку форматирования, которая подробно описана в следующих разделах форматирования:

• Дополнительные сведения о функции составного форматирования см. в составныхформатирования.

• Дополнительные сведения об описателях числовых форматов см. в строках стандартного числового формата и пользовательских строк числовых форматов.

• Дополнительные сведения о описателях формата даты и времени см. в строках стандартного формата даты и времени и настраиваемых строк формата даты и времени.

• Дополнительные сведения об описателях формата перечисления см. в строках формата перечисления.

• Дополнительные сведения о форматировании см. в типов форматирования.

Параметр format состоит из нуля или нескольких запусков текста, пересекающихся с нуля или более индексированных заполнителей, называемых элементами форматирования, которые соответствуют объекту в списке параметров этого метода. Процесс форматирования заменяет каждый элемент формата строковым представлением значения соответствующего объекта.

Синтаксис элемента формата выглядит следующим образом:

{индекс[,длина][:formatString]}

Элементы в квадратных скобках являются необязательными. В следующей таблице описан каждый элемент. Дополнительные сведения о функции составного форматирования, включая синтаксис элемента форматирования, см. в составной.

Элемент	Описание
индекс	Отсчитываемая от нуля позиция в списке параметров объекта, который необходимо отформатировать. Если объект, указанный индексом, null, элемент форматирования заменяется String.Empty. Так как эта перегрузка содержит три объекта в списке параметров, значение индекса всегда должно быть равно 0, 1 или 2. Если в позиции индекса нет параметра, создается FormatException.
,длина	Минимальное количество символов в строковом представлении параметра. Если положительный, параметр выровнен по правому краю; Если отрицательный, он выровнен по левому краю.
:formatString	Стандартная или настраиваемая строка форматирования, поддерживаемая объектом для форматирования. Возможные значения для formatString совпадают со значениями, поддерживаемыми методом ToString(string format) объекта. Если formatString не указан, а объект, который будет отформатирован, реализует интерфейс IFormattable, null передается в качестве значения параметра format, используемого в качестве строки формата IFormattable.ToString.

Требуются начальные и конечные символы фигурных скобок "{" и "}". Чтобы указать один литеральный символ фигурной скобки в format, укажите два начальных или конечных символа фигурных скобок; то есть "{" или "}}".

Этот метод не выполняет поиск указанной строки для отдельных символов новой строки (шестнадцатеричные 0x000a) и заменяет их TextWriter.NewLine.

Если указанный объект не ссылается в строке формата, он игнорируется.

Список распространенных задач ввода-вывода см. в разделе Распространенные задачи ввода-вывода.

См. также раздел

• StreamWriter
• StringWriter
• IFormatProvider
• файлов и потоковой ввода-вывода
• Практическое руководство. Чтение текста из файла
• Практическое руководство. Запись текста в файл

Write(Char[], Int32, Int32)

Исходный код:

TextWriter.cs

Записывает вложенные символы в текстовый поток.

public:
 virtual void Write(cli::array <char> ^ buffer, int index, int count);

public virtual void Write (char[] buffer, int index, int count);

abstract member Write : char[] * int * int -> unit
override this.Write : char[] * int * int -> unit

Public Overridable Sub Write (buffer As Char(), index As Integer, count As Integer)

Параметры

buffer

Char[]

Массив символов для записи данных из.

index

Int32

Положение символа в буфере, с которого начинается извлечение данных.

count

Int32

Число записываемых символов.

Исключения

ArgumentException

Длина буфера минус index меньше count.

ArgumentNullException

Параметр buffernull.

ArgumentOutOfRangeException

index или count отрицательно.

ObjectDisposedException

TextWriter закрыт.

IOException

Возникает ошибка ввода-вывода.

Комментарии

Этот метод записывает count символы данных в этот TextWriter из массива символов buffer начиная с позиции index.

Эта перегрузка эквивалентна перегрузке Write(Char[]) для каждого символа в buffer между index и (index + count).

Список распространенных задач ввода-вывода см. в разделе Распространенные задачи ввода-вывода.

См. также раздел

• Write(Char[], Int32, Int32)
• Write(Char[], Int32, Int32)
• файлов и потоковой ввода-вывода
• Практическое руководство. Чтение текста из файла
• Практическое руководство. Запись текста в файл

Write(String, Object[])

Исходный код:

TextWriter.cs

Записывает форматированную строку в текстовый поток, используя ту же семантику, что и метод Format(String, Object[]).

public:
 virtual void Write(System::String ^ format, ... cli::array <System::Object ^> ^ arg);

public virtual void Write (string format, params object?[] arg);

abstract member Write : string * obj[] -> unit
override this.Write : string * obj[] -> unit

Public Overridable Sub Write (format As String, ParamArray arg As Object())

Параметры

format

String

Строка составного формата.

arg

Object[]

Массив объектов, содержащий ноль или больше объектов для форматирования и записи.

Исключения

ArgumentNullException

format или argnull.

ObjectDisposedException

TextWriter закрыт.

IOException

Возникает ошибка ввода-вывода.

FormatException

format не является допустимой строкой составного формата.

-или-

Индекс элемента формата меньше 0 (ноль) или больше или равен длине массива arg.

Комментарии

Этот метод использует составное форматирование для преобразования значения объекта в строковое представление и внедрения этого представления в строку. .NET предоставляет обширную поддержку форматирования, которая подробно описана в следующих разделах форматирования:

• Дополнительные сведения о функции составного форматирования см. в составныхформатирования.

• Дополнительные сведения об описателях числовых форматов см. в строках стандартного числового формата и пользовательских строк числовых форматов.

• Дополнительные сведения о описателях формата даты и времени см. в строках стандартного формата даты и времени и настраиваемых строк формата даты и времени.

• Дополнительные сведения об описателях формата перечисления см. в строках формата перечисления.

• Дополнительные сведения о форматировании см. в типов форматирования.

Параметр format состоит из нуля или нескольких запусков текста, пересекающихся с нуля или более индексированных заполнителей, называемых элементами форматирования, которые соответствуют объекту в списке параметров этого метода. Процесс форматирования заменяет каждый элемент формата строковым представлением значения соответствующего объекта.

Синтаксис элемента формата выглядит следующим образом:

{индекс[,длина][:formatString]}

Элементы в квадратных скобках являются необязательными. В следующей таблице описан каждый элемент. Дополнительные сведения о функции составного форматирования, включая синтаксис элемента форматирования, см. в составной.

Элемент	Описание
индекс	Отсчитываемая от нуля позиция в списке параметров объекта, который необходимо отформатировать. Если объект, указанный индексом, null, элемент форматирования заменяется String.Empty. Так как эта перегрузка содержит массив в списке параметров, значение индекса всегда должно быть меньше длины массива. Если в позиции индекса нет параметра, создается FormatException.
,длина	Минимальное количество символов в строковом представлении параметра. Если положительный, параметр выровнен по правому краю; Если отрицательный, он выровнен по левому краю.
:formatString	Стандартная или настраиваемая строка форматирования, поддерживаемая объектом для форматирования. Возможные значения для formatString совпадают со значениями, поддерживаемыми методом ToString(string format) объекта. Если formatString не указан, а объект, который будет отформатирован, реализует интерфейс IFormattable, null передается в качестве значения параметра format, используемого в качестве строки формата IFormattable.ToString.

Требуются начальные и конечные символы фигурных скобок "{" и "}". Чтобы указать один литеральный символ фигурной скобки в format, укажите два начальных или конечных символа фигурных скобок; то есть "{" или "}}".

Этот метод не выполняет поиск указанной строки для отдельных символов новой строки (шестнадцатеричные 0x000a) и заменяет их TextWriter.NewLine.

Если указанный объект не ссылается в строке формата, он игнорируется.

Список распространенных задач ввода-вывода см. в разделе Распространенные задачи ввода-вывода.

См. также раздел

• StreamWriter
• StringWriter
• IFormatProvider
• файлов и потоковой ввода-вывода
• Практическое руководство. Чтение текста из файла
• Практическое руководство. Запись текста в файл

Write(String, Object)

Исходный код:

TextWriter.cs

Записывает форматированную строку в текстовый поток, используя ту же семантику, что и метод Format(String, Object).

public:
 virtual void Write(System::String ^ format, System::Object ^ arg0);

public virtual void Write (string format, object? arg0);

abstract member Write : string * obj -> unit
override this.Write : string * obj -> unit

Public Overridable Sub Write (format As String, arg0 As Object)

Параметры

format

String

Строка составного формата.

arg0

Object

Объект для форматирования и записи.

Исключения

ArgumentNullException

format null.

ObjectDisposedException

TextWriter закрыт.

IOException

Возникает ошибка ввода-вывода.

FormatException

format не является допустимой строкой составного формата.

-или-

Индекс элемента форматирования меньше 0 (ноль) или больше или равен числу объектов, отформатированных (которое для перегрузки этого метода является одним).

Комментарии

Этот метод использует составное форматирование для преобразования значения объекта в строковое представление и внедрения этого представления в строку. .NET предоставляет обширную поддержку форматирования, которая подробно описана в следующих разделах форматирования:

• Дополнительные сведения о функции составного форматирования см. в составныхформатирования.

• Дополнительные сведения об описателях числовых форматов см. в строках стандартного числового формата и пользовательских строк числовых форматов.

• Дополнительные сведения о описателях формата даты и времени см. в строках стандартного формата даты и времени и настраиваемых строк формата даты и времени.

• Дополнительные сведения об описателях формата перечисления см. в строках формата перечисления.

• Дополнительные сведения о форматировании см. в типов форматирования.

Параметр format состоит из нуля или нескольких запусков текста, пересекающихся с нуля или более индексированных заполнителей, называемых элементами форматирования, которые соответствуют объекту в списке параметров этого метода. Процесс форматирования заменяет каждый элемент формата строковым представлением значения соответствующего объекта.

Синтаксис элемента формата выглядит следующим образом:

{индекс[,длина][:formatString]}

Элементы в квадратных скобках являются необязательными. В следующей таблице описан каждый элемент. Дополнительные сведения о функции составного форматирования, включая синтаксис элемента форматирования, см. в составной.

Элемент	Описание
индекс	Отсчитываемая от нуля позиция в списке параметров объекта, который необходимо отформатировать. Если объект, указанный индексом, null, элемент форматирования заменяется String.Empty. Так как эта перегрузка содержит только один объект в списке параметров, значение индекса всегда должно быть равно 0. Если в позиции индекса нет параметра, создается FormatException.
,длина	Минимальное количество символов в строковом представлении параметра. Если положительный, параметр выровнен по правому краю; Если отрицательный, он выровнен по левому краю.
:formatString	Стандартная или настраиваемая строка форматирования, поддерживаемая объектом для форматирования. Возможные значения для formatString совпадают со значениями, поддерживаемыми методом ToString(string format) объекта. Если formatString не указан, а объект, который будет отформатирован, реализует интерфейс IFormattable, null передается в качестве значения параметра format, используемого в качестве строки формата IFormattable.ToString.

Требуются начальные и конечные символы фигурных скобок "{" и "}". Чтобы указать один литеральный символ фигурной скобки в format, укажите два начальных или конечных символа фигурных скобок; то есть "{" или "}}".

Этот метод не выполняет поиск указанной строки для отдельных символов новой строки (шестнадцатеричные 0x000a) и заменяет их TextWriter.NewLine.

Если указанный объект не ссылается в строке формата, он игнорируется.

Список распространенных задач ввода-вывода см. в разделе Распространенные задачи ввода-вывода.

См. также раздел

• StreamWriter
• StringWriter
• IFormatProvider
• файлов и потоковой ввода-вывода
• Практическое руководство. Чтение текста из файла
• Практическое руководство. Запись текста в файл

Write(UInt64)

Исходный код:

TextWriter.cs

Важно!

Этот API несовместим с CLS.

Записывает текстовое представление 8-байтового целого числа без знака в текстовый поток.

public:
 virtual void Write(System::UInt64 value);

[System.CLSCompliant(false)]
public virtual void Write (ulong value);

[<System.CLSCompliant(false)>]
abstract member Write : uint64 -> unit
override this.Write : uint64 -> unit

Public Overridable Sub Write (value As ULong)

Параметры

value

UInt64

8-байтовое целое число без знака для записи.

Атрибуты

CLSCompliantAttribute

Исключения

ObjectDisposedException

TextWriter закрыт.

IOException

Возникает ошибка ввода-вывода.

Комментарии

Текстовое представление указанного значения создается путем вызова метода UInt64.ToString. Свойство TextWriter.FormatProvider, если оно не null, указывает форматирование, зависяющее от языка и региональных параметров.

Список распространенных задач ввода-вывода см. в разделе Распространенные задачи ввода-вывода.

См. также раздел

• StreamWriter
• StringWriter
• IFormatProvider
• файлов и потоковой ввода-вывода
• Практическое руководство. Чтение текста из файла
• Практическое руководство. Запись текста в файл

Write(UInt32)

Исходный код:

TextWriter.cs

Важно!

Этот API несовместим с CLS.

Записывает текстовое представление 4-байтового целого числа без знака в текстовый поток.

public:
 virtual void Write(System::UInt32 value);

[System.CLSCompliant(false)]
public virtual void Write (uint value);

[<System.CLSCompliant(false)>]
abstract member Write : uint32 -> unit
override this.Write : uint32 -> unit

Public Overridable Sub Write (value As UInteger)

Параметры

value

UInt32

4-байтовое целое число без знака для записи.

Атрибуты

CLSCompliantAttribute

Исключения

ObjectDisposedException

TextWriter закрыт.

IOException

Возникает ошибка ввода-вывода.

Комментарии

Текстовое представление указанного значения создается путем вызова метода UInt32.ToString. Свойство TextWriter.FormatProvider, если оно не null, указывает форматирование, зависяющее от языка и региональных параметров.

Список распространенных задач ввода-вывода см. в разделе Распространенные задачи ввода-вывода.

См. также раздел

• StreamWriter
• StringWriter
• IFormatProvider
• файлов и потоковой ввода-вывода
• Практическое руководство. Чтение текста из файла
• Практическое руководство. Запись текста в файл

Write(StringBuilder)

Исходный код:

TextWriter.cs

Записывает построитель строк в текстовый поток.

public:
 virtual void Write(System::Text::StringBuilder ^ value);

public virtual void Write (System.Text.StringBuilder? value);

abstract member Write : System.Text.StringBuilder -> unit
override this.Write : System.Text.StringBuilder -> unit

Public Overridable Sub Write (value As StringBuilder)

Параметры

value

StringBuilder

Строка, как построитель строк, для записи в текстовый поток.

Комментарии

Этот метод эквивалентен Write(stringBuilder.ToString()), но использует метод StringBuilder.GetChunks, чтобы избежать создания промежуточной строки.

Write(String)

Исходный код:

TextWriter.cs

Записывает строку в текстовый поток.

public:
 virtual void Write(System::String ^ value);

public virtual void Write (string? value);

abstract member Write : string -> unit
override this.Write : string -> unit

Public Overridable Sub Write (value As String)

Параметры

value

String

Строка для записи.

Исключения

ObjectDisposedException

TextWriter закрыт.

IOException

Возникает ошибка ввода-вывода.

Комментарии

Эта перегрузка эквивалентна перегрузке Write(Char[]).

Этот метод не выполняет поиск указанной строки для отдельных символов новой строки (шестнадцатеричные 0x000a) и заменяет их TextWriter.NewLine.

Если valuenull, ничего не записывается в текстовый поток.

Список распространенных задач ввода-вывода см. в разделе Распространенные задачи ввода-вывода.

См. также раздел

• Write(String)
• Write(String)
• файлов и потоковой ввода-вывода
• Практическое руководство. Чтение текста из файла
• Практическое руководство. Запись текста в файл

Write(Single)

Исходный код:

TextWriter.cs

Записывает текстовое представление 4-байтового значения с плавающей запятой в текстовый поток.

public:
 virtual void Write(float value);

public virtual void Write (float value);

abstract member Write : single -> unit
override this.Write : single -> unit

Public Overridable Sub Write (value As Single)

Параметры

value

Single

4-байтовое значение с плавающей запятой для записи.

Исключения

ObjectDisposedException

TextWriter закрыт.

IOException

Возникает ошибка ввода-вывода.

Комментарии

Текстовое представление указанного значения создается путем вызова метода Single.ToString. Свойство TextWriter.FormatProvider, если оно не null, указывает форматирование, зависяющее от языка и региональных параметров.

Список распространенных задач ввода-вывода см. в разделе Распространенные задачи ввода-вывода.

См. также раздел

• StreamWriter
• StringWriter
• IFormatProvider
• файлов и потоковой ввода-вывода
• Практическое руководство. Чтение текста из файла
• Практическое руководство. Запись текста в файл

Write(String, Object, Object)

Исходный код:

TextWriter.cs

Записывает форматированную строку в текстовый поток, используя ту же семантику, что и метод Format(String, Object, Object).

public:
 virtual void Write(System::String ^ format, System::Object ^ arg0, System::Object ^ arg1);

public virtual void Write (string format, object? arg0, object? arg1);

abstract member Write : string * obj * obj -> unit
override this.Write : string * obj * obj -> unit

Public Overridable Sub Write (format As String, arg0 As Object, arg1 As Object)

Параметры

format

String

Строка составного формата.

arg0

Object

Первый объект для форматирования и записи.

arg1

Object

Второй объект для форматирования и записи.

Исключения

ArgumentNullException

format null.

ObjectDisposedException

TextWriter закрыт.

IOException

Возникает ошибка ввода-вывода.

FormatException

format не является допустимой строкой составного формата.

-или-

Индекс элемента форматирования меньше 0 (ноль) или больше или равен числу объектов, отформатированных (которое для перегрузки этого метода равно двум).

Комментарии

Этот метод использует составное форматирование для преобразования значения объекта в строковое представление и внедрения этого представления в строку. .NET предоставляет обширную поддержку форматирования, которая подробно описана в следующих разделах форматирования:

• Дополнительные сведения о функции составного форматирования см. в составныхформатирования.

• Дополнительные сведения об описателях числовых форматов см. в строках стандартного числового формата и пользовательских строк числовых форматов.

• Дополнительные сведения о описателях формата даты и времени см. в строках стандартного формата даты и времени и настраиваемых строк формата даты и времени.

• Дополнительные сведения об описателях формата перечисления см. в строках формата перечисления.

• Дополнительные сведения о форматировании см. в типов форматирования.

Параметр format состоит из нуля или нескольких запусков текста, пересекающихся с нуля или более индексированных заполнителей, называемых элементами форматирования, которые соответствуют объекту в списке параметров этого метода. Процесс форматирования заменяет каждый элемент формата строковым представлением значения соответствующего объекта.

Синтаксис элемента формата выглядит следующим образом:

{индекс[,длина][:formatString]}

Элементы в квадратных скобках являются необязательными. В следующей таблице описан каждый элемент. Дополнительные сведения о функции составного форматирования, включая синтаксис элемента форматирования, см. в составной.

Элемент	Описание
индекс	Отсчитываемая от нуля позиция в списке параметров объекта, который необходимо отформатировать. Если объект, указанный индексом, null, элемент форматирования заменяется String.Empty. Так как эта перегрузка содержит два объекта в списке параметров, значение индекса всегда должно быть равно 0 или 1. Если в позиции индекса нет параметра, создается FormatException.
,длина	Минимальное количество символов в строковом представлении параметра. Если положительный, параметр выровнен по правому краю; Если отрицательный, он выровнен по левому краю.
:formatString	Стандартная или настраиваемая строка форматирования, поддерживаемая объектом для форматирования. Возможные значения для formatString совпадают со значениями, поддерживаемыми методом ToString(string format) объекта. Если formatString не указан, а объект, который будет отформатирован, реализует интерфейс IFormattable, null передается в качестве значения параметра format, используемого в качестве строки формата IFormattable.ToString.

Требуются начальные и конечные символы фигурных скобок "{" и "}". Чтобы указать один литеральный символ фигурной скобки в format, укажите два начальных или конечных символа фигурных скобок; то есть "{" или "}}".

Этот метод не выполняет поиск указанной строки для отдельных символов новой строки (шестнадцатеричные 0x000a) и заменяет их TextWriter.NewLine.

Если указанный объект не ссылается в строке формата, он игнорируется.

Список распространенных задач ввода-вывода см. в разделе Распространенные задачи ввода-вывода.

См. также раздел

• StreamWriter
• StringWriter
• IFormatProvider
• файлов и потоковой ввода-вывода
• Практическое руководство. Чтение текста из файла
• Практическое руководство. Запись текста в файл

Write(Object)

Исходный код:

TextWriter.cs

Записывает текстовое представление объекта в текстовый поток, вызвав метод ToString для этого объекта.

public:
 virtual void Write(System::Object ^ value);

public virtual void Write (object? value);

abstract member Write : obj -> unit
override this.Write : obj -> unit

Public Overridable Sub Write (value As Object)

Параметры

value

Object

Объект для записи.

Исключения

ObjectDisposedException

TextWriter закрыт.

IOException

Возникает ошибка ввода-вывода.

Комментарии

Эта перегрузка эквивалентна перегрузке Write(String).

Если указанный объект null, действие не выполняется и исключение не возникает. В противном случае метод ToString объекта вызывается для создания строкового представления, а результирующая строка записывается в выходной поток. Свойство FormatProvider, если оно не null, указывает форматирование, зависяющее от языка и региональных параметров.

Список распространенных задач ввода-вывода см. в разделе Распространенные задачи ввода-вывода.

См. также раздел

• StreamWriter
• StringWriter
• IFormatProvider
• файлов и потоковой ввода-вывода
• Практическое руководство. Чтение текста из файла
• Практическое руководство. Запись текста в файл

Write(Int64)

Исходный код:

TextWriter.cs

Записывает текстовое представление 8-байтового целого числа со знаком в текстовый поток.

public:
 virtual void Write(long value);

public virtual void Write (long value);

abstract member Write : int64 -> unit
override this.Write : int64 -> unit

Public Overridable Sub Write (value As Long)

Параметры

value

Int64

8-байтовое целое число со знаком для записи.

Исключения

ObjectDisposedException

TextWriter закрыт.

IOException

Возникает ошибка ввода-вывода.

Комментарии

Текстовое представление указанного значения создается путем вызова метода Int64.ToString. Свойство TextWriter.FormatProvider, если оно не null, указывает форматирование, зависяющее от языка и региональных параметров.

Список распространенных задач ввода-вывода см. в разделе Распространенные задачи ввода-вывода.

Практическое руководство. Запись текста в файл

См. также раздел

• StreamWriter
• StringWriter
• IFormatProvider

Write(Int32)

Исходный код:

TextWriter.cs

Записывает текстовое представление 4-байтового целого числа со знаком в текстовый поток.

public:
 virtual void Write(int value);

public virtual void Write (int value);

abstract member Write : int -> unit
override this.Write : int -> unit

Public Overridable Sub Write (value As Integer)

Параметры

value

Int32

Целое число со знаком 4 байта для записи.

Исключения

ObjectDisposedException

TextWriter закрыт.

IOException

Возникает ошибка ввода-вывода.

Комментарии

Текстовое представление указанного значения создается путем вызова метода Int32.ToString. Свойство TextWriter.FormatProvider, если оно не null, указывает форматирование, зависяющее от языка и региональных параметров.

Список распространенных задач ввода-вывода см. в разделе Распространенные задачи ввода-вывода.

См. также раздел

• StreamWriter
• StringWriter
• IFormatProvider
• файлов и потоковой ввода-вывода
• Практическое руководство. Чтение текста из файла
• Практическое руководство. Запись текста в файл

Write(Double)

Исходный код:

TextWriter.cs

Записывает текстовое представление 8-байтового значения с плавающей запятой в текстовый поток.

public:
 virtual void Write(double value);

public virtual void Write (double value);

abstract member Write : double -> unit
override this.Write : double -> unit

Public Overridable Sub Write (value As Double)

Параметры

value

Double

8-байтовое значение с плавающей запятой для записи.

Исключения

ObjectDisposedException

TextWriter закрыт.

IOException

Возникает ошибка ввода-вывода.

Комментарии

Текстовое представление указанного значения создается путем вызова метода Double.ToString. Свойство TextWriter.FormatProvider, если оно не null, указывает форматирование, зависяющее от языка и региональных параметров.

Список распространенных задач ввода-вывода см. в разделе Распространенные задачи ввода-вывода.

См. также раздел

• StreamWriter
• StringWriter
• IFormatProvider
• файлов и потоковой ввода-вывода
• Практическое руководство. Чтение текста из файла
• Практическое руководство. Запись текста в файл

Write(Decimal)

Исходный код:

TextWriter.cs

Записывает текстовое представление десятичного значения в текстовый поток.

public:
 virtual void Write(System::Decimal value);

public virtual void Write (decimal value);

abstract member Write : decimal -> unit
override this.Write : decimal -> unit

Public Overridable Sub Write (value As Decimal)

Параметры

value

Decimal

Десятичное значение для записи.

Исключения

ObjectDisposedException

TextWriter закрыт.

IOException

Возникает ошибка ввода-вывода.

Комментарии

Свойство FormatProvider, если оно не null, указывает форматирование, зависяющее от языка и региональных параметров.

См. также раздел

• StreamWriter
• StringWriter
• IFormatProvider
• файлов и потоковой ввода-вывода
• Практическое руководство. Чтение текста из файла
• Практическое руководство. Запись текста в файл

Write(Char[])

Исходный код:

TextWriter.cs

Записывает массив символов в текстовый поток.

public:
 virtual void Write(cli::array <char> ^ buffer);

public virtual void Write (char[]? buffer);

abstract member Write : char[] -> unit
override this.Write : char[] -> unit

Public Overridable Sub Write (buffer As Char())

Параметры

buffer

Char[]

Массив символов для записи в текстовый поток.

Исключения

ObjectDisposedException

TextWriter закрыт.

IOException

Возникает ошибка ввода-вывода.

Комментарии

Этот метод не выполняет поиск указанной строки для отдельных символов новой строки (шестнадцатеричные 0x000a) и заменяет их NewLine.

Этот метод по умолчанию вызывает метод Write(Char[], Int32, Int32) и передает весь массив символов. Если массив символов null, ничего не записывается.

Список распространенных задач ввода-вывода см. в разделе Распространенные задачи ввода-вывода.

См. также раздел

• Write(Char[])
• файлов и потоковой ввода-вывода
• Практическое руководство. Чтение текста из файла
• Практическое руководство. Запись текста в файл

Write(Char)

Исходный код:

TextWriter.cs

Записывает символ в текстовый поток.

public:
 virtual void Write(char value);

public virtual void Write (char value);

abstract member Write : char -> unit
override this.Write : char -> unit

Public Overridable Sub Write (value As Char)

Параметры

value

Char

Символ для записи в текстовый поток.

Исключения

ObjectDisposedException

TextWriter закрыт.

IOException

Возникает ошибка ввода-вывода.

Комментарии

Этот метод по умолчанию ничего не делает, но производные классы могут переопределить метод для предоставления соответствующих функциональных возможностей.

Список распространенных задач ввода-вывода см. в разделе Распространенные задачи ввода-вывода.

См. также раздел

• Write(Char)
• Write(Char)
• файлов и потоковой ввода-вывода
• Практическое руководство. Чтение текста из файла
• Практическое руководство. Запись текста в файл

Write(Boolean)

Исходный код:

TextWriter.cs

Записывает текстовое представление значения Boolean в текстовый поток.

public:
 virtual void Write(bool value);

public virtual void Write (bool value);

abstract member Write : bool -> unit
override this.Write : bool -> unit

Public Overridable Sub Write (value As Boolean)

Параметры

value

Boolean

Значение Boolean для записи.

Исключения

ObjectDisposedException

TextWriter закрыт.

IOException

Возникает ошибка ввода-вывода.

Комментарии

Текстовое представление указанного значения создается путем вызова метода Boolean.ToString.

Этот метод выводит Boolean.TrueString или Boolean.FalseString.

Список распространенных задач ввода-вывода см. в разделе Распространенные задачи ввода-вывода.

См. также раздел

• StreamWriter
• StringWriter
• файлов и потоковой ввода-вывода
• Практическое руководство. Чтение текста из файла
• Практическое руководство. Запись текста в файл

Write(ReadOnlySpan<Char>)

Исходный код:

TextWriter.cs

Записывает диапазон символов в текстовый поток.

public:
 virtual void Write(ReadOnlySpan<char> buffer);

public virtual void Write (ReadOnlySpan<char> buffer);

abstract member Write : ReadOnlySpan<char> -> unit
override this.Write : ReadOnlySpan<char> -> unit

Public Overridable Sub Write (buffer As ReadOnlySpan(Of Char))

Параметры

buffer

ReadOnlySpan<Char>

Диапазон символов для записи.

Комментарии

Текстовое представление указанного значения создается путем вызова ReadOnlySpan<Char>. Метод ToString.

Список распространенных задач ввода-вывода см. в разделе Распространенные задачи ввода-вывода.