Была ли эта страница полезной?
Ваш отзыв об этом контенте важен для нас. Расскажите нам о том, что вы думаете.
Дополнительный отзыв?
1500 символов осталось
Экспорт (0) Печать
Развернуть все
Данная статья переведена автоматически. Наведите указатель мыши на предложения статьи, чтобы просмотреть исходный текст. Дополнительные сведения.
Перевод
Текст оригинала

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

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

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

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

Параметры

format
Тип: System.String
Строка составного формата (см. Заметки).
arg0
Тип: System.Object
Первый объект для форматирования и записи.
arg1
Тип: System.Object
Второй объект для форматирования и записи.

ИсключениеУсловие
ArgumentNullException

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

ObjectDisposedException

Объект TextWriter закрыт.

IOException

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

FormatException

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

-или-

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

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

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

Для элемента формата используется следующий синтаксис:

{индекс[,длина][:строкаФормата]}

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

Элемент

Описание

индекс

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

,длина

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

:строкаФормата

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

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

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

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

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

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

.NET Framework

Поддерживается в версиях: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework (клиентский профиль)

Поддерживается в версиях: 4, 3.5 с пакетом обновления 1 (SP1)

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista с пакетом обновления 2 (SP2), Windows Server 2008 (роль основных серверных компонентов не поддерживается), Windows Server 2008 R2 (роль основных серверных компонентов поддерживается в пакете обновления 1 (SP1) или выше; системы на базе Itanium не поддерживаются)

Среда .NET Framework поддерживает не все версии каждой платформы. Поддерживаемые версии перечислены в разделе Требования к системе для .NET Framework.

Добавления сообщества

ДОБАВИТЬ
Показ:
© 2015 Microsoft