Экспорт (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.

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

ДОБАВИТЬ
Корпорация Майкрософт проводит интернет-опрос, чтобы выяснить ваше мнение о веб-сайте MSDN. Если вы желаете принять участие в этом интернет-опросе, он будет отображен при закрытии веб-сайта MSDN.

Вы хотите принять участие?
Показ:
© 2014 Microsoft