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

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

 

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

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

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

public virtual void Write(
	string format,
	object arg0
)

Параметры

format
Type: System.String

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

arg0
Type: System.Object

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

Exception Condition
ArgumentNullException

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

ObjectDisposedException

TextWriter закрыт.

IOException

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

FormatException

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

-или-

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

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

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

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

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

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

Элемент

Описание

индекс

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

,Длина

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

:formatString

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

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

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

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

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

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