TextWriter.WriteLine Метод

Определение

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

System.IO

Сборки:

netstandard.dll, System.Runtime.dll

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

Перегрузки

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

WriteLine(String, Object, Object, Object)

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

TextWriter.cs

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

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

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

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

Public Overridable Sub WriteLine (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 состоит из нуля или нескольких запусков текста, пересекающихся с нуля или более индексированных заполнителей, называемых элементами форматирования, которые соответствуют объекту в списке параметров этого метода. Процесс форматирования заменяет каждый элемент формата строковым представлением значения соответствующего объекта.

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

{index[,length][:formatString]}

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

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

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

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

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

Терминатор строки определяется полем CoreNewLine .

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

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

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

WriteLine(String, Object, Object)

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

TextWriter.cs

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

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

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

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

Public Overridable Sub WriteLine (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 состоит из нуля или нескольких запусков текста, пересекающихся с нуля или более индексированных заполнителей, называемых элементами форматирования, которые соответствуют объекту в списке параметров этого метода. Процесс форматирования заменяет каждый элемент формата строковым представлением значения соответствующего объекта.

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

{index[,length][:formatString]}

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

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

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

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

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

Терминатор строки определяется полем CoreNewLine .

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

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

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

WriteLine(Char[], Int32, Int32)

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

TextWriter.cs

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

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

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

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

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

Параметры

buffer

Char[]

Массив символов, из которого считываются данные.

index

Int32

Позиция символа, в buffer которой начинается чтение данных.

count

Int32

Максимальное количество символов для записи.

Исключения

ArgumentException

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

ArgumentNullException

Параметр buffer имеет значение null.

ArgumentOutOfRangeException

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

ObjectDisposedException

Закрыто TextWriter .

IOException

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

Комментарии

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

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

Терминатор строки определяется полем CoreNewLine .

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

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

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

WriteLine(String, ReadOnlySpan<Object>)

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

TextWriter.cs

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

public:
 virtual void WriteLine(System::String ^ format, ReadOnlySpan<System::Object ^> arg);

public virtual void WriteLine(string format, scoped ReadOnlySpan<object?> arg);

abstract member WriteLine : string * ReadOnlySpan<obj> -> unit
override this.WriteLine : string * ReadOnlySpan<obj> -> unit

Public Overridable Sub WriteLine (format As String, arg As ReadOnlySpan(Of Object))

Параметры

format

String

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

arg

ReadOnlySpan<Object>

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

WriteLine(String, Object[])

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

TextWriter.cs

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

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

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

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

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

Параметры

format

String

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

arg

Object[]

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

Исключения

ArgumentNullException

Строка или объект передаются как null.

ObjectDisposedException

Закрыто TextWriter .

IOException

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

FormatException

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

-или-

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

Комментарии

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

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

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

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

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

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

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

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

{index[,length][:formatString]}

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

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

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

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

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

Терминатор строки определяется полем CoreNewLine .

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

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

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

WriteLine(String, Object)

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

TextWriter.cs

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

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

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

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

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

Параметры

format

String

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

arg0

Object

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

Исключения

ArgumentNullException

format равно null.

ObjectDisposedException

Закрыто TextWriter .

IOException

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

FormatException

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

-или-

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

Комментарии

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

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

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

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

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

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

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

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

{index[,length][:formatString]}

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

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

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

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

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

Терминатор строки определяется полем CoreNewLine .

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

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

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

WriteLine(UInt64)

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

TextWriter.cs

Внимание

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

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

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

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

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

Public Overridable Sub WriteLine (value As ULong)

Параметры

value

UInt64

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

Атрибуты

CLSCompliantAttribute

Исключения

ObjectDisposedException

Закрыто TextWriter .

IOException

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

Комментарии

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

Терминатор строки определяется полем CoreNewLine .

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

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

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

WriteLine(UInt32)

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

TextWriter.cs

Внимание

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

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

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

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

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

Public Overridable Sub WriteLine (value As UInteger)

Параметры

value

UInt32

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

Атрибуты

CLSCompliantAttribute

Исключения

ObjectDisposedException

Закрыто TextWriter .

IOException

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

Комментарии

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

Терминатор строки определяется полем CoreNewLine .

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

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

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

WriteLine(String)

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

TextWriter.cs

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

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

public virtual void WriteLine(string? value);

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

Public Overridable Sub WriteLine (value As String)

Параметры

value

String

Строка для записи. В противном valuenullслучае записывается только терминатор строки.

Исключения

ObjectDisposedException

Закрыто TextWriter .

IOException

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

Комментарии

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

Терминатор строки определяется полем CoreNewLine .

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

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

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

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

WriteLine(Single)

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

TextWriter.cs

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

public:
 virtual void WriteLine(float value);

public virtual void WriteLine(float value);

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

Public Overridable Sub WriteLine (value As Single)

Параметры

value

Single

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

Исключения

ObjectDisposedException

Закрыто TextWriter .

IOException

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

Комментарии

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

Терминатор строки определяется полем CoreNewLine .

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

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

WriteLine(StringBuilder)

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

TextWriter.cs

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

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

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

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

Public Overridable Sub WriteLine (value As StringBuilder)

Параметры

value

StringBuilder

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

Комментарии

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

Терминатор строки определяется полем CoreNewLine .

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

WriteLine(Object)

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

TextWriter.cs

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

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

public virtual void WriteLine(object? value);

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

Public Overridable Sub WriteLine (value As Object)

Параметры

value

Object

Объект для записи. В противном valuenullслучае записывается только терминатор строки.

Исключения

ObjectDisposedException

Закрыто TextWriter .

IOException

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

Комментарии

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

Терминатор строки определяется полем CoreNewLine .

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

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

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

WriteLine(Int64)

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

TextWriter.cs

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

public:
 virtual void WriteLine(long value);

public virtual void WriteLine(long value);

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

Public Overridable Sub WriteLine (value As Long)

Параметры

value

Int64

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

Исключения

ObjectDisposedException

Закрыто TextWriter .

IOException

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

Комментарии

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

Терминатор строки определяется полем CoreNewLine .

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

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

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

WriteLine(Int32)

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

TextWriter.cs

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

public:
 virtual void WriteLine(int value);

public virtual void WriteLine(int value);

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

Public Overridable Sub WriteLine (value As Integer)

Параметры

value

Int32

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

Исключения

ObjectDisposedException

Закрыто TextWriter .

IOException

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

Комментарии

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

Терминатор строки определяется полем CoreNewLine .

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

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

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

WriteLine(Double)

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

TextWriter.cs

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

public:
 virtual void WriteLine(double value);

public virtual void WriteLine(double value);

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

Public Overridable Sub WriteLine (value As Double)

Параметры

value

Double

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

Исключения

ObjectDisposedException

Закрыто TextWriter .

IOException

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

Комментарии

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

Терминатор строки определяется полем CoreNewLine .

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

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

WriteLine(Decimal)

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

TextWriter.cs

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

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

public virtual void WriteLine(decimal value);

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

Public Overridable Sub WriteLine (value As Decimal)

Параметры

value

Decimal

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

Исключения

ObjectDisposedException

Закрыто TextWriter .

IOException

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

Комментарии

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

Терминатор строки определяется полем CoreNewLine .

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

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

WriteLine(Char[])

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

TextWriter.cs

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

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

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

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

Public Overridable Sub WriteLine (buffer As Char())

Параметры

buffer

Char[]

Массив символов, из которого считываются данные.

Исключения

ObjectDisposedException

Закрыто TextWriter .

IOException

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

Комментарии

Все символы записываются buffer в базовый поток. Если массив символов равен null, записывается только терминатор строки.

Эта перегрузка эквивалентна следующей Write(Char[])WriteLine() .

Терминатор строки определяется полем CoreNewLine .

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

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

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

WriteLine(Char)

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

TextWriter.cs

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

public:
 virtual void WriteLine(char value);

public virtual void WriteLine(char value);

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

Public Overridable Sub WriteLine (value As Char)

Параметры

value

Char

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

Исключения

ObjectDisposedException

Закрыто TextWriter .

IOException

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

Комментарии

Эта перегрузка эквивалентна следующей Write(Char)WriteLine() .

Терминатор строки определяется полем CoreNewLine .

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

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

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

WriteLine(Boolean)

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

TextWriter.cs

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

public:
 virtual void WriteLine(bool value);

public virtual void WriteLine(bool value);

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

Public Overridable Sub WriteLine (value As Boolean)

Параметры

value

Boolean

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

Исключения

ObjectDisposedException

Закрыто TextWriter .

IOException

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

Комментарии

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

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

Терминатор строки определяется полем CoreNewLine .

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

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

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

WriteLine()

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

TextWriter.cs

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

public:
 virtual void WriteLine();

public virtual void WriteLine();

abstract member WriteLine : unit -> unit
override this.WriteLine : unit -> unit

Public Overridable Sub WriteLine ()

Исключения

ObjectDisposedException

Закрыто TextWriter .

IOException

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

Комментарии

Терминатор строки определяется полем CoreNewLine .

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

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

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

WriteLine(ReadOnlySpan<Char>)

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

TextWriter.cs

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

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

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

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

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

Параметры

buffer

ReadOnlySpan<Char>

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

Комментарии

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

Терминатор строки определяется полем CoreNewLine .

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