TextWriter.WriteLine Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Записывает в текстовый поток данные, за которыми следует признак конца строки.
Перегрузки
WriteLine(String, Object, Object) |
Записывает форматированную строку и перенос строки в текстовый поток, используя ту же семантику, что и метод Format(String, Object, Object). |
WriteLine(Char[], Int32, Int32) |
Записывает в текстовый поток подмассив символов, за которым следует признак конца строки. |
WriteLine(String, ReadOnlySpan<Object>) | |
WriteLine(String, Object[]) |
Записывает форматированную строку и перенос строки в текстовый поток, используя ту же семантику, что и Format(String, Object). |
WriteLine(String, Object) |
Записывает форматированную строку и перенос строки в текстовый поток, используя ту же семантику, что и метод Format(String, Object). |
WriteLine(UInt64) |
Записывает в текстовый поток текстовое представление целого числа без знака размером 8 байт, за которым следует признак конца строки. |
WriteLine(String, Object, Object, Object) |
Записывает форматированную строку и перенос строки в текстовый поток, используя ту же семантику, что и Format(String, Object). |
WriteLine(UInt32) |
Записывает в текстовый поток текстовое представление целого числа без знака размером 4 байта, за которым следует признак конца строки. |
WriteLine(StringBuilder) |
Записывает в текстовый поток текстовое представление построителя строки, за которым следует знак конца строки. |
WriteLine(String) |
Записывает в текстовый поток строку, за которой следует признак конца строки. |
WriteLine(Single) |
Записывает в текстовый поток текстовое представление значения с плавающей запятой размером 4 байта, за которым следует признак конца строки. |
WriteLine(Double) |
Записывает в текстовый поток текстовое представление значения с плавающей запятой размером 8 байт, за которым следует признак конца строки. |
WriteLine(Object) |
Записывает в текстовый поток текстовое представление объекта путем вызова метода |
WriteLine(Int64) |
Записывает в текстовый поток текстовое представление целого числа со знаком размером 8 байт, за которым следует признак конца строки. |
WriteLine(Int32) |
Записывает в текстовый поток текстовое представление целого числа со знаком размером 4 байта, за которым следует признак конца строки. |
WriteLine(Decimal) |
Записывает в текстовый поток текстовое представление десятичного значения, за которым следует знак конца строки. |
WriteLine(Char[]) |
Записывает в текстовый поток массив символов, за которыми следует признак конца строки. |
WriteLine(Char) |
Записывает в текстовый поток символ, за которым следует признак конца строки. |
WriteLine(Boolean) |
Записывает в текстовый поток текстовое представление значения типа |
WriteLine() |
Записывает признак конца строки в текстовый поток. |
WriteLine(ReadOnlySpan<Char>) |
Записывает в текстовый поток текстовое представление диапазона символов, за которым следует знак конца строки. |
WriteLine(String, Object, Object)
- Исходный код:
- TextWriter.cs
- Исходный код:
- TextWriter.cs
- Исходный код:
- 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);
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
Второй объект для форматирования и записи.
Исключения
format
имеет значение null
.
Объект TextWriter закрыт.
Ошибка ввода-вывода.
Параметр format
не является допустимой строкой составного формата.
-или-
Индекс элемента формата меньше 0 (нуля) или больше или равен числу объектов, которые необходимо отформатировать (которое для этой перегрузки метода равно 2).
Комментарии
Этот метод использует составное форматирование для преобразования значения объекта в его строковое представление и для внедрения этого представления в строку. .NET предоставляет расширенную поддержку форматирования, которая более подробно описана в следующих разделах:
Дополнительные сведения о функции составного форматирования см. в разделе Составное форматирование.
Дополнительные сведения об описателях числовых форматов см. в разделах Строки стандартного числового формата и Строки настраиваемого числового формата.
Дополнительные сведения об описателях формата даты и времени см. в разделах Стандартные строки формата даты и времени и Настраиваемые строки формата даты и времени.
Дополнительные сведения об описателях формата перечисления см. в разделе Строки формата перечисления.
Дополнительные сведения о форматировании см. в разделе Типы форматирования.
Параметр format
состоит из нуля или более выполнений текста, перемешанных с нулевым или несколькими индексированных заполнителей, называемых элементами форматирования, которые соответствуют объекту в списке параметров этого метода. Процесс форматирования заменяет каждый элемент форматирования строковым представлением значения соответствующего объекта.
Синтаксис элемента форматирования выглядит следующим образом:
{index[,length][:formatString]}
Элементы в квадратных скобках являются необязательными. Каждый из элементов описан в таблице ниже. Дополнительные сведения о функции составного форматирования, включая синтаксис элемента форматирования, см. в разделе Составное форматирование.
Элемент | Описание |
---|---|
index | Отсчитываемая от нуля позиция в списке параметров отформатированного объекта. Если объект, заданный индексом , имеет значение 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
- Исходный код:
- TextWriter.cs
- Исходный код:
- 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
Наибольшее количество символов для записи.
Исключения
Длина буфера минус index
меньше count
.
Параметр buffer
имеет значение null
.
index
или count
является отрицательным значением.
Объект TextWriter закрыт.
Ошибка ввода-вывода.
Комментарии
Этот метод записывает count
в нее TextWriter
символы данных из массива buffer
символов, начиная с позиции index
.
Эта перегрузка эквивалентна вызову Write(Char[]) метода , за которым следует WriteLine для каждого символа index
между buffer
и ( + index
count
).
Признак конца строки определяется полем CoreNewLine .
Список распространенных задач ввода-вывода см. в разделе Общие задачи ввода-вывода.
См. также раздел
- StreamWriter
- StringWriter
- Файловый и потоковый ввод-вывод
- Практическое руководство. Чтение текста из файла
- Практическое руководство. Запись текста в файл
Применяется к
WriteLine(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
- Исходный код:
- TextWriter.cs
- Исходный код:
- 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);
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[]
Массив объектов, содержащий от нуля и более объектов, которые необходимо форматировать и записать.
Исключения
Строка или объект передаются в виде null
.
Объект TextWriter закрыт.
Ошибка ввода-вывода.
Параметр format
не является допустимой строкой составного формата.
-или-
Индекс элемента формата меньше нуля или больше либо равен длине массива arg
.
Комментарии
Этот метод использует составное форматирование для преобразования значения объекта в его строковое представление и для внедрения этого представления в строку. .NET предоставляет обширную поддержку форматирования, которая более подробно описана в следующих разделах форматирования:
Дополнительные сведения о функции составного форматирования см. в разделе Составное форматирование.
Дополнительные сведения об описателях числовых форматов см. в разделах Строки стандартного числового формата и Строки пользовательского числового формата.
Дополнительные сведения об описателях формата даты и времени см. в разделах Стандартные строки формата даты и времени и Настраиваемые строки формата даты и времени.
Дополнительные сведения об описателях формата перечисления см. в разделе Строки формата перечисления.
Дополнительные сведения о форматировании см. в разделе Типы форматирования.
Параметр format
состоит из нуля или более выполнений текста, перемешанных с нулем или более индексированных заполнителей, называемых элементами формата, которые соответствуют объекту в списке параметров этого метода. Процесс форматирования заменяет каждый элемент форматирования строковым представлением значения соответствующего объекта.
Синтаксис элемента форматирования выглядит следующим образом:
{index[,length][:formatString]}
Элементы в квадратных скобках являются необязательными. Каждый из элементов описан в таблице ниже. Дополнительные сведения о функции составного форматирования, включая синтаксис элемента форматирования, см. в разделе Составное форматирование.
Элемент | Описание |
---|---|
index | Отсчитываемая от нуля позиция в списке параметров отформатированного объекта. Если объект, заданный индексом , имеет значение 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
- Исходный код:
- TextWriter.cs
- Исходный код:
- TextWriter.cs
Записывает форматированную строку и перенос строки в текстовый поток, используя ту же семантику, что и метод Format(String, Object).
public:
virtual void WriteLine(System::String ^ format, System::Object ^ arg0);
public virtual void WriteLine (string format, 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
Объект для форматирования и записи.
Исключения
format
имеет значение null
.
Объект TextWriter закрыт.
Ошибка ввода-вывода.
Параметр format
не является допустимой строкой составного формата.
-или-
Индекс элемента формата меньше 0 (нуля) или больше или равен числу объектов, которые необходимо отформатировать (которое для этой перегрузки метода равно 1).
Комментарии
Этот метод использует составное форматирование для преобразования значения объекта в его строковое представление и для внедрения этого представления в строку. .NET предоставляет обширную поддержку форматирования, которая более подробно описана в следующих разделах форматирования:
Дополнительные сведения о функции составного форматирования см. в разделе Составное форматирование.
Дополнительные сведения об описателях числовых форматов см. в разделах Строки стандартного числового формата и Строки пользовательского числового формата.
Дополнительные сведения об описателях формата даты и времени см. в разделах Стандартные строки формата даты и времени и Настраиваемые строки формата даты и времени.
Дополнительные сведения об описателях формата перечисления см. в разделе Строки формата перечисления.
Дополнительные сведения о форматировании см. в разделе Типы форматирования.
Параметр format
состоит из нуля или более выполнений текста, перемешанных с нулем или более индексированных заполнителей, называемых элементами формата, которые соответствуют объекту в списке параметров этого метода. Процесс форматирования заменяет каждый элемент форматирования строковым представлением значения соответствующего объекта.
Синтаксис элемента форматирования выглядит следующим образом:
{index[,length][:formatString]}
Элементы в квадратных скобках являются необязательными. Каждый из элементов описан в таблице ниже. Дополнительные сведения о функции составного форматирования, включая синтаксис элемента форматирования, см. в разделе Составное форматирование.
Элемент | Описание |
---|---|
index | Отсчитываемая от нуля позиция в списке параметров отформатированного объекта. Если объект, заданный индексом , имеет значение 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
- Исходный код:
- TextWriter.cs
- Исходный код:
- 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 байт.
- Атрибуты
Исключения
Объект TextWriter закрыт.
Ошибка ввода-вывода.
Комментарии
Текстовое представление указанного значения создается путем UInt64.ToString вызова метода . Свойство FormatProvider , если нет null
, задает форматирование, зависят от языка и региональных параметров.
Признак конца строки определяется полем CoreNewLine .
Список распространенных задач ввода-вывода см. в разделе Общие задачи ввода-вывода.
См. также раздел
- StreamWriter
- StringWriter
- IFormatProvider
- Файловый и потоковый ввод-вывод
- Практическое руководство. Чтение текста из файла
- Практическое руководство. Запись текста в файл
Применяется к
WriteLine(String, Object, Object, Object)
- Исходный код:
- TextWriter.cs
- Исходный код:
- TextWriter.cs
- Исходный код:
- 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);
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
Третий объект для форматирования и записи.
Исключения
format
имеет значение null
.
Объект TextWriter закрыт.
Ошибка ввода-вывода.
Параметр format
не является допустимой строкой составного формата.
-или-
Индекс элемента формата меньше 0 (нуля) или больше или равен числу объектов, которые необходимо отформатировать (которое для этой перегрузки метода равно 3).
Комментарии
Этот метод использует составное форматирование для преобразования значения объекта в его строковое представление и для внедрения этого представления в строку. .NET предоставляет обширную поддержку форматирования, которая более подробно описана в следующих разделах форматирования:
Дополнительные сведения о функции составного форматирования см. в разделе Составное форматирование.
Дополнительные сведения об описателях числовых форматов см. в разделах Строки стандартного числового формата и Строки пользовательского числового формата.
Дополнительные сведения об описателях формата даты и времени см. в разделах Стандартные строки формата даты и времени и Настраиваемые строки формата даты и времени.
Дополнительные сведения об описателях формата перечисления см. в разделе Строки формата перечисления.
Дополнительные сведения о форматировании см. в разделе Типы форматирования.
Параметр format
состоит из нуля или более выполнений текста, перемешанных с нулем или более индексированных заполнителей, называемых элементами формата, которые соответствуют объекту в списке параметров этого метода. Процесс форматирования заменяет каждый элемент форматирования строковым представлением значения соответствующего объекта.
Синтаксис элемента форматирования выглядит следующим образом:
{index[,length][:formatString]}
Элементы в квадратных скобках являются необязательными. Каждый из элементов описан в таблице ниже. Дополнительные сведения о функции составного форматирования, включая синтаксис элемента форматирования, см. в разделе Составное форматирование.
Элемент | Описание |
---|---|
index | Отсчитываемая от нуля позиция в списке параметров отформатированного объекта. Если объект, заданный индексом , имеет значение 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(UInt32)
- Исходный код:
- TextWriter.cs
- Исходный код:
- TextWriter.cs
- Исходный код:
- 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 байта.
- Атрибуты
Исключения
Объект TextWriter закрыт.
Ошибка ввода-вывода.
Комментарии
Текстовое представление указанного значения создается путем UInt32.ToString вызова метода . Свойство FormatProvider , если нет null
, задает форматирование, зависят от языка и региональных параметров.
Признак конца строки определяется полем CoreNewLine .
Список распространенных задач ввода-вывода см. в разделе Общие задачи ввода-вывода.
См. также раздел
- StreamWriter
- StringWriter
- IFormatProvider
- Файловый и потоковый ввод-вывод
- Практическое руководство. Чтение текста из файла
- Практическое руководство. Запись текста в файл
Применяется к
WriteLine(StringBuilder)
- Исходный код:
- TextWriter.cs
- Исходный код:
- TextWriter.cs
- Исходный код:
- 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(String)
- Исходный код:
- TextWriter.cs
- Исходный код:
- TextWriter.cs
- Исходный код:
- TextWriter.cs
Записывает в текстовый поток строку, за которой следует признак конца строки.
public:
virtual void WriteLine(System::String ^ value);
public virtual void WriteLine (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
Строка для записи. Если value
имеет значение null
, записывается только признак конца строки.
Исключения
Объект TextWriter закрыт.
Ошибка ввода-вывода.
Комментарии
Эта перегрузка эквивалентна перегрузке Write(Char[]) .
Признак конца строки определяется полем CoreNewLine .
Этот метод не выполняет поиск отдельных символов перехода на новую строку (шестнадцатеричное представление 0x000a) в указанной строке и не заменяет их значением свойства NewLine.
Список распространенных задач ввода-вывода см. в разделе Общие задачи ввода-вывода.
См. также раздел
- StreamWriter
- StringWriter
- Файловый и потоковый ввод-вывод
- Практическое руководство. Чтение текста из файла
- Практическое руководство. Запись текста в файл
Применяется к
WriteLine(Single)
- Исходный код:
- TextWriter.cs
- Исходный код:
- TextWriter.cs
- Исходный код:
- 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 байта.
Исключения
Объект TextWriter закрыт.
Ошибка ввода-вывода.
Комментарии
Свойство FormatProvider , если нет null
, задает форматирование, зависят от языка и региональных параметров. Список распространенных задач ввода-вывода см. в разделе Общие задачи ввода-вывода.
Признак конца строки определяется полем CoreNewLine .
См. также раздел
- StreamWriter
- StringWriter
- IFormatProvider
- Файловый и потоковый ввод-вывод
- Практическое руководство. Чтение текста из файла
- Практическое руководство. Запись текста в файл
Применяется к
WriteLine(Double)
- Исходный код:
- TextWriter.cs
- Исходный код:
- TextWriter.cs
- Исходный код:
- 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 байт.
Исключения
Объект TextWriter закрыт.
Ошибка ввода-вывода.
Комментарии
Свойство FormatProvider , если нет null
, задает форматирование, зависят от языка и региональных параметров. Список распространенных задач ввода-вывода см. в разделе Общие задачи ввода-вывода.
Признак конца строки определяется полем CoreNewLine .
См. также раздел
- StreamWriter
- StringWriter
- IFormatProvider
- Файловый и потоковый ввод-вывод
- Практическое руководство. Чтение текста из файла
- Практическое руководство. Запись текста в файл
Применяется к
WriteLine(Object)
- Исходный код:
- TextWriter.cs
- Исходный код:
- TextWriter.cs
- Исходный код:
- TextWriter.cs
Записывает в текстовый поток текстовое представление объекта путем вызова метода ToString
для этого объекта, за которым следует признак конца строки.
public:
virtual void WriteLine(System::Object ^ value);
public virtual void WriteLine (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
Записываемый объект. Если value
имеет значение null
, записывается только признак конца строки.
Исключения
Объект TextWriter закрыт.
Ошибка ввода-вывода.
Комментарии
Эта перегрузка эквивалентна перегрузке Write(String, Object) . Свойство FormatProvider , если нет null
, задает форматирование, зависят от языка и региональных параметров.
Признак конца строки определяется полем CoreNewLine .
Список распространенных задач ввода-вывода см. в разделе Общие задачи ввода-вывода.
См. также раздел
- StreamWriter
- StringWriter
- IFormatProvider
- Файловый и потоковый ввод-вывод
- Практическое руководство. Чтение текста из файла
- Практическое руководство. Запись текста в файл
Применяется к
WriteLine(Int64)
- Исходный код:
- TextWriter.cs
- Исходный код:
- TextWriter.cs
- Исходный код:
- 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 байт.
Исключения
Объект TextWriter закрыт.
Ошибка ввода-вывода.
Комментарии
Текстовое представление указанного значения создается путем Int64.ToString вызова метода . Свойство TextWriter.FormatProvider , если нет null
, задает форматирование, зависят от языка и региональных параметров.
Признак конца строки определяется полем CoreNewLine .
Список распространенных задач ввода-вывода см. в разделе Общие задачи ввода-вывода.
См. также раздел
- StreamWriter
- StringWriter
- IFormatProvider
- Файловый и потоковый ввод-вывод
- Практическое руководство. Чтение текста из файла
- Практическое руководство. Запись текста в файл
Применяется к
WriteLine(Int32)
- Исходный код:
- TextWriter.cs
- Исходный код:
- TextWriter.cs
- Исходный код:
- 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 байта.
Исключения
Объект TextWriter закрыт.
Ошибка ввода-вывода.
Комментарии
Текстовое представление указанного значения создается путем Int32.ToString вызова метода . Свойство TextWriter.FormatProvider , если нет null
, задает форматирование, зависят от языка и региональных параметров.
Признак конца строки определяется полем CoreNewLine .
Список распространенных задач ввода-вывода см. в разделе Общие задачи ввода-вывода.
См. также раздел
- StreamWriter
- StringWriter
- IFormatProvider
- Файловый и потоковый ввод-вывод
- Практическое руководство. Чтение текста из файла
- Практическое руководство. Запись текста в файл
Применяется к
WriteLine(Decimal)
- Исходный код:
- TextWriter.cs
- Исходный код:
- TextWriter.cs
- Исходный код:
- 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
Десятичное значение, которое необходимо записать.
Исключения
Объект TextWriter закрыт.
Ошибка ввода-вывода.
Комментарии
Свойство FormatProvider , если нет null
, задает форматирование, зависят от языка и региональных параметров. Список распространенных задач ввода-вывода см. в разделе Общие задачи ввода-вывода.
Признак конца строки определяется полем CoreNewLine .
См. также раздел
- StreamWriter
- StringWriter
- IFormatProvider
- Файловый и потоковый ввод-вывод
- Практическое руководство. Чтение текста из файла
- Практическое руководство. Запись текста в файл
Применяется к
WriteLine(Char[])
- Исходный код:
- TextWriter.cs
- Исходный код:
- TextWriter.cs
- Исходный код:
- TextWriter.cs
Записывает в текстовый поток массив символов, за которыми следует признак конца строки.
public:
virtual void WriteLine(cli::array <char> ^ buffer);
public virtual void WriteLine (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[]
Массив символов, из которого считываются данные.
Исключения
Объект TextWriter закрыт.
Ошибка ввода-вывода.
Комментарии
Все символы в записываются в buffer
базовый поток. Если массив символов имеет значение null
, записывается только признак конца строки.
Эта перегрузка эквивалентна следующей Write(Char[]) за ней WriteLine() .
Признак конца строки определяется полем CoreNewLine .
Список распространенных задач ввода-вывода см. в разделе Общие задачи ввода-вывода.
См. также раздел
- StreamWriter
- StringWriter
- Файловый и потоковый ввод-вывод
- Практическое руководство. Чтение текста из файла
- Практическое руководство. Запись текста в файл
Применяется к
WriteLine(Char)
- Исходный код:
- TextWriter.cs
- Исходный код:
- TextWriter.cs
- Исходный код:
- 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
Символ, записываемый в текстовый поток.
Исключения
Объект TextWriter закрыт.
Ошибка ввода-вывода.
Комментарии
Эта перегрузка эквивалентна следующей Write(Char) за ней WriteLine() .
Признак конца строки определяется полем CoreNewLine .
Список распространенных задач ввода-вывода см. в разделе Общие задачи ввода-вывода.
См. также раздел
- StreamWriter
- StringWriter
- Файловый и потоковый ввод-вывод
- Практическое руководство. Чтение текста из файла
- Практическое руководство. Запись текста в файл
Применяется к
WriteLine(Boolean)
- Исходный код:
- TextWriter.cs
- Исходный код:
- TextWriter.cs
- Исходный код:
- 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
для записи.
Исключения
Объект TextWriter закрыт.
Ошибка ввода-вывода.
Комментарии
Текстовое представление указанного значения создается путем Boolean.ToString вызова метода .
Этот метод выводит или Boolean.TrueStringBoolean.FalseString.
Признак конца строки определяется полем CoreNewLine .
Список распространенных задач ввода-вывода см. в разделе Общие задачи ввода-вывода.
См. также раздел
- StreamWriter
- StringWriter
- Файловый и потоковый ввод-вывод
- Практическое руководство. Чтение текста из файла
- Практическое руководство. Запись текста в файл
Применяется к
WriteLine()
- Исходный код:
- TextWriter.cs
- Исходный код:
- TextWriter.cs
- Исходный код:
- TextWriter.cs
Записывает признак конца строки в текстовый поток.
public:
virtual void WriteLine();
public virtual void WriteLine ();
abstract member WriteLine : unit -> unit
override this.WriteLine : unit -> unit
Public Overridable Sub WriteLine ()
Исключения
Объект TextWriter закрыт.
Ошибка ввода-вывода.
Комментарии
Признак конца строки определяется полем CoreNewLine .
Список распространенных задач ввода-вывода см. в разделе Общие задачи ввода-вывода.
См. также раздел
- StreamWriter
- StringWriter
- Файловый и потоковый ввод-вывод
- Практическое руководство. Чтение текста из файла
- Практическое руководство. Запись текста в файл
Применяется к
WriteLine(ReadOnlySpan<Char>)
- Исходный код:
- TextWriter.cs
- Исходный код:
- TextWriter.cs
- Исходный код:
- 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<. Метод ToString.
Признак конца строки определяется полем CoreNewLine .
Список распространенных задач ввода-вывода см. в разделе Общие задачи ввода-вывода.
Применяется к
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по