TextWriter.WriteLine Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Записывает данные в текстовый поток, за которым следует терминатор строки.
Перегрузки
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(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 (ноль) или больше или равен числу объектов, отформатированных (что для перегрузки этого метода составляет два).
Комментарии
Этот метод использует составное форматирование для преобразования значения объекта в строковое представление и внедрения этого представления в строку. .NET предоставляет обширную поддержку форматирования, которая подробно описана в следующих разделах форматирования:
Дополнительные сведения о функции составного форматирования см. в составныхформатирования.
Дополнительные сведения об описателях числовых форматов см. в строках стандартного числового формата и пользовательских строк числовых форматов.
Дополнительные сведения о описателях формата даты и времени см. в строках стандартного формата даты и времени и настраиваемых строк формата даты и времени.
Дополнительные сведения об описателях формата перечисления см. в строках формата перечисления.
Дополнительные сведения о форматировании см. в типов форматирования.
Параметр format
состоит из нуля или нескольких запусков текста, пересекающихся с нуля или более индексированных заполнителей, называемых элементами форматирования, которые соответствуют объекту в списке параметров этого метода. Процесс форматирования заменяет каждый элемент формата строковым представлением значения соответствующего объекта.
Синтаксис элемента формата выглядит следующим образом:
{индекс[,длина][: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
- Исходный код:
- 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 для каждого символа в buffer
между index
и (index
+ count
).
Терминатор строки определяется полем CoreNewLine.
Список распространенных задач ввода-вывода см. в разделе Распространенные задачи ввода-вывода.
См. также раздел
- StreamWriter
- StringWriter
- файлов и потоковой ввода-вывода
- Практическое руководство. Чтение текста из файла
- Практическое руководство. Запись текста в файл
Применяется к
WriteLine(String, ReadOnlySpan<Object>)
Записывает форматированную строку и новую строку в текстовый поток, используя ту же семантику, что и 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
- Исходный код:
- 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
не является допустимой строкой составного формата.
-или-
Индекс элемента формата меньше 0 (ноль) или больше или равен длине массива arg
.
Комментарии
Этот метод использует составное форматирование для преобразования значения объекта в строковое представление и внедрения этого представления в строку. .NET предоставляет обширную поддержку форматирования, которая подробно описана в следующих разделах форматирования:
Дополнительные сведения о функции составного форматирования см. в составныхформатирования.
Дополнительные сведения об описателях числовых форматов см. в строках стандартного числового формата и пользовательских строк числовых форматов.
Дополнительные сведения о описателях формата даты и времени см. в строках стандартного формата даты и времени и настраиваемых строк формата даты и времени.
Дополнительные сведения об описателях формата перечисления см. в строках формата перечисления.
Дополнительные сведения о форматировании см. в типов форматирования.
Параметр format
состоит из нуля или нескольких запусков текста, пересекающихся с нуля или более индексированных заполнителей, называемых элементами форматирования, которые соответствуют объекту в списке параметров этого метода. Процесс форматирования заменяет каждый элемент формата строковым представлением значения соответствующего объекта.
Синтаксис элемента формата выглядит следующим образом:
{индекс[,длина][: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
- Исходный код:
- 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 (ноль) или больше или равен числу объектов, отформатированных (которое для перегрузки этого метода является одним).
Комментарии
Этот метод использует составное форматирование для преобразования значения объекта в строковое представление и внедрения этого представления в строку. .NET предоставляет обширную поддержку форматирования, которая подробно описана в следующих разделах форматирования:
Дополнительные сведения о функции составного форматирования см. в составныхформатирования.
Дополнительные сведения об описателях числовых форматов см. в строках стандартного числового формата и пользовательских строк числовых форматов.
Дополнительные сведения о описателях формата даты и времени см. в строках стандартного формата даты и времени и настраиваемых строк формата даты и времени.
Дополнительные сведения об описателях формата перечисления см. в строках формата перечисления.
Дополнительные сведения о форматировании см. в типов форматирования.
Параметр format
состоит из нуля или нескольких запусков текста, пересекающихся с нуля или более индексированных заполнителей, называемых элементами форматирования, которые соответствуют объекту в списке параметров этого метода. Процесс форматирования заменяет каждый элемент формата строковым представлением значения соответствующего объекта.
Синтаксис элемента формата выглядит следующим образом:
{индекс[,длина][: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
- Исходный код:
- 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 (ноль) или больше или равен числу объектов, отформатированных (для перегрузки этого метода — три).
Комментарии
Этот метод использует составное форматирование для преобразования значения объекта в строковое представление и внедрения этого представления в строку. .NET предоставляет обширную поддержку форматирования, которая подробно описана в следующих разделах форматирования:
Дополнительные сведения о функции составного форматирования см. в составныхформатирования.
Дополнительные сведения об описателях числовых форматов см. в строках стандартного числового формата и пользовательских строк числовых форматов.
Дополнительные сведения о описателях формата даты и времени см. в строках стандартного формата даты и времени и настраиваемых строк формата даты и времени.
Дополнительные сведения об описателях формата перечисления см. в строках формата перечисления.
Дополнительные сведения о форматировании см. в типов форматирования.
Параметр format
состоит из нуля или нескольких запусков текста, пересекающихся с нуля или более индексированных заполнителей, называемых элементами форматирования, которые соответствуют объекту в списке параметров этого метода. Процесс форматирования заменяет каждый элемент формата строковым представлением значения соответствующего объекта.
Синтаксис элемента формата выглядит следующим образом:
{индекс[,длина][: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(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.TrueString или Boolean.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<Char>. Метод ToString.
Терминатор строки определяется полем CoreNewLine.
Список распространенных задач ввода-вывода см. в разделе Распространенные задачи ввода-вывода.