Данная статья переведена с помощью средств машинного перевода. Чтобы просмотреть ее на английском языке, установите флажок Английский. Вы также можете просматривать английский текст во всплывающем окне, наводя указатель мыши на переведенный текст.
Перевод
Английский

Метод TextWriter.WriteLine (String, Object, Object)

 

Опубликовано: Октябрь 2016

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

Пространство имен:   System.IO
Сборка:  mscorlib (в mscorlib.dll)

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

Параметры

format
Type: System.String

Строка составного формата (см. Заметки).

arg0
Type: System.Object

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

arg1
Type: System.Object

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

Exception Condition
ArgumentNullException

Свойство format имеет значение null.

ObjectDisposedException

TextWriter закрыт.

IOException

Ошибка ввода-вывода.

FormatException

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

-или-

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

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

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

Синтаксис элемента формата таков:

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

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

Элемент

Описание

индекс

Отсчитываемая от нуля позиция форматируемого объекта в списке параметров. Если объект, заданный параметром индексnull, элемент формата заменяется String.Empty. Поскольку данная перегрузка содержит два объекта в его параметр списка, значение индекс всегда должен быть 0 или 1. Если не существует параметра в индекс позиции, FormatException возникает исключение.

,Длина

Минимальное число символов в строковом представлении параметра. Если положительное, параметр по правому краю; Если значение отрицательное, это по левому краю.

:formatString

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

Открывающие и закрывающие фигурные скобки, "{" и "}", обязательны. Для указания единичного литерала фигурной скобки в format, используйте две открывающие или закрывающие фигурные скобки; то есть «{{» или «}}».

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

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

Признак конца строки определяется CoreNewLine поле.

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

Универсальная платформа Windows
Доступно с 10
.NET Framework
Доступно с 1.1
Silverlight
Доступно с 2.0
Windows Phone Silverlight
Доступно с 7.0
Вернуться в начало
Показ: