TextWriter.Write Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Записывает данные в текстовый поток.
Перегрузки
Write(String, Object, Object, Object) |
Записывает форматированную строку в текстовый поток, используя ту же семантику, что и метод Format(String, Object, Object, Object). |
Write(Char[], Int32, Int32) |
Записывает подмассив символов в текстовый поток. |
Write(String, Object[]) |
Записывает форматированную строку в текстовый поток, используя ту же семантику, что и метод Format(String, Object[]). |
Write(String, Object) |
Записывает форматированную строку в текстовый поток, используя ту же семантику, что и метод Format(String, Object). |
Write(UInt64) |
Записывает в текстовый поток текстовое представление целого числа без знака размером 8 байт. |
Write(UInt32) |
Записывает в текстовый поток текстовое представление целого числа без знака размером 4 байта. |
Write(StringBuilder) |
Записывает построитель строки в текстовый поток. |
Write(String) |
Асинхронно записывает строку в текстовый поток. |
Write(Single) |
Записывает в текстовый поток текстовое представление значения с плавающей запятой размером 4 байта. |
Write(String, Object, Object) |
Записывает форматированную строку в текстовый поток, используя ту же семантику, что и метод Format(String, Object, Object). |
Write(Object) |
Записывает в текстовый поток текстовое представление объекта с помощью вызова метода |
Write(Int64) |
Записывает в текстовый поток текстовое представление целого числа со знаком размером 8 байт. |
Write(Int32) |
Записывает в текстовый поток текстовое представление целого числа со знаком размером 4 байта. |
Write(Double) |
Записывает в текстовый поток текстовое представление значения с плавающей запятой размером 8 байт. |
Write(Decimal) |
Записывает текстовое представление десятичного значения в текстовый поток. |
Write(Char[]) |
Записывает массив символов в текстовый поток. |
Write(Char) |
Записывает символ в текстовый поток. |
Write(Boolean) |
Записывает текстовое представление значения типа |
Write(ReadOnlySpan<Char>) |
Записывает диапазон символов в текстовый поток. |
Write(String, Object, Object, Object)
- Исходный код:
- TextWriter.cs
- Исходный код:
- TextWriter.cs
- Исходный код:
- TextWriter.cs
Записывает форматированную строку в текстовый поток, используя ту же семантику, что и метод Format(String, Object, Object, Object).
public:
virtual void Write(System::String ^ format, System::Object ^ arg0, System::Object ^ arg1, System::Object ^ arg2);
public virtual void Write (string format, object arg0, object arg1, object arg2);
public virtual void Write (string format, object? arg0, object? arg1, object? arg2);
abstract member Write : string * obj * obj * obj -> unit
override this.Write : string * obj * obj * obj -> unit
Public Overridable Sub Write (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 (нуля) или больше или равен числу объектов, которые необходимо отформатировать (которое для этой перегрузки метода равно 3).
Комментарии
Этот метод использует составное форматирование для преобразования значения объекта в его строковое представление и для внедрения этого представления в строку. .NET предоставляет обширную поддержку форматирования, которая более подробно описана в следующих разделах форматирования:
Дополнительные сведения о функции составного форматирования см. в разделе Составное форматирование.
Дополнительные сведения об описателях числовых форматов см. в разделах Строки стандартного числового формата и Строки пользовательского числового формата.
Дополнительные сведения об описателях формата даты и времени см. в разделах Стандартные строки формата даты и времени и Настраиваемые строки формата даты и времени.
Дополнительные сведения об описателях формата перечисления см. в разделе Строки формата перечисления.
Дополнительные сведения о форматировании см. в разделе Типы форматирования.
Параметр format
состоит из нуля или более выполнений текста, перемешанных с нулем или более индексированных заполнителей, называемых элементами формата, которые соответствуют объекту в списке параметров этого метода. Процесс форматирования заменяет каждый элемент форматирования строковым представлением значения соответствующего объекта.
Синтаксис элемента форматирования выглядит следующим образом:
{index[,length][:formatString]}
Элементы в квадратных скобках являются необязательными. Каждый из элементов описан в таблице ниже. Дополнительные сведения о функции составного форматирования, включая синтаксис элемента форматирования, см. в разделе Составное форматирование.
Элемент | Описание |
---|---|
index | Отсчитываемая от нуля позиция в списке параметров отформатированного объекта. Если объект, заданный индексом , имеет значение null , элемент формата заменяется String.Emptyна . Так как эта перегрузка содержит три объекта в списке параметров, значение индекса всегда должно быть равно 0, 1 или 2. Если в позиции индекса нет параметра, FormatException создается исключение . |
, длина | Минимальное число символов в строковом представлении параметра. Если положительный результат, параметр выравнивается по правому краю; Если отрицательный, он выравнивается по левому краю. |
:formatString | Строка стандартного или настраиваемого формата, поддерживаемая отформатированным объектом. Возможные значения для formatString совпадают со значениями, поддерживаемыми методом объекта ToString(string format) . Если formatString не указан, а отформатированный объект реализует IFormattable интерфейс, null передается в качестве значения параметра, используемого format в качестве строки форматирования IFormattable.ToString . |
Требуются начальные и конечные символы фигурных скобок : "{" и "}". Чтобы указать один литеральный символ фигурной скобки в format
, укажите два начальных или конечных символа скобки, т. е. "{{" или "}}".
Этот метод не выполняет поиск отдельных символов перехода на новую строку (шестнадцатеричное представление 0x000a) в указанной строке и не заменяет их значением свойства TextWriter.NewLine.
Если указанный объект не указан в строке формата, он игнорируется.
Список распространенных задач ввода-вывода см. в разделе Общие задачи ввода-вывода.
См. также раздел
- StreamWriter
- StringWriter
- IFormatProvider
- Файловый и потоковый ввод-вывод
- Практическое руководство. Чтение текста из файла
- Практическое руководство. Запись текста в файл
Применяется к
Write(Char[], Int32, Int32)
- Исходный код:
- TextWriter.cs
- Исходный код:
- TextWriter.cs
- Исходный код:
- TextWriter.cs
Записывает подмассив символов в текстовый поток.
public:
virtual void Write(cli::array <char> ^ buffer, int index, int count);
public virtual void Write (char[] buffer, int index, int count);
abstract member Write : char[] * int * int -> unit
override this.Write : char[] * int * int -> unit
Public Overridable Sub Write (buffer As Char(), index As Integer, count As Integer)
Параметры
- buffer
- Char[]
Массив символов, из которого записываются данные.
- index
- Int32
Положение символа в буфере, с которого начинается извлечение данных.
- count
- Int32
Количество символов для записи.
Исключения
Длина буфера минус index
меньше count
.
Параметр buffer
имеет значение null
.
index
или count
является отрицательным значением.
Объект TextWriter закрыт.
Ошибка ввода-вывода.
Комментарии
Этот метод записывает count
в нее TextWriter
символы данных из массива buffer
символов, начиная с позиции index
.
Эта перегрузка эквивалентна перегрузке Write(Char[]) для каждого символа между index
buffer
и (index
+ count
).
Список распространенных задач ввода-вывода см. в разделе Общие задачи ввода-вывода.
См. также раздел
- Write(Char[], Int32, Int32)
- Write(Char[], Int32, Int32)
- Файловый и потоковый ввод-вывод
- Практическое руководство. Чтение текста из файла
- Практическое руководство. Запись текста в файл
Применяется к
Write(String, Object[])
- Исходный код:
- TextWriter.cs
- Исходный код:
- TextWriter.cs
- Исходный код:
- TextWriter.cs
Записывает форматированную строку в текстовый поток, используя ту же семантику, что и метод Format(String, Object[]).
public:
virtual void Write(System::String ^ format, ... cli::array <System::Object ^> ^ arg);
public virtual void Write (string format, params object[] arg);
public virtual void Write (string format, params object?[] arg);
abstract member Write : string * obj[] -> unit
override this.Write : string * obj[] -> unit
Public Overridable Sub Write (format As String, ParamArray arg As Object())
Параметры
- format
- String
Строка составного формата.
- arg
- Object[]
Массив объектов, содержащий от нуля и более объектов, которые необходимо форматировать и записать.
Исключения
Параметр format
или arg
имеет значение null
.
Объект TextWriter закрыт.
Ошибка ввода-вывода.
Параметр format
не является допустимой строкой составного формата.
-или-
Индекс элемента формата меньше нуля или больше либо равен длине массива arg
.
Комментарии
Этот метод использует составное форматирование для преобразования значения объекта в его строковое представление и для внедрения этого представления в строку. .NET предоставляет расширенную поддержку форматирования, которая более подробно описана в следующих разделах:
Дополнительные сведения о функции составного форматирования см. в разделе Составное форматирование.
Дополнительные сведения об описателях числовых форматов см. в разделах Строки стандартного числового формата и Строки настраиваемого числового формата.
Дополнительные сведения об описателях формата даты и времени см. в разделах Стандартные строки формата даты и времени и Настраиваемые строки формата даты и времени.
Дополнительные сведения об описателях формата перечисления см. в разделе Строки формата перечисления.
Дополнительные сведения о форматировании см. в разделе Типы форматирования.
Параметр format
состоит из нуля или более выполнений текста, перемешанных с нулевым или несколькими индексированных заполнителей, называемых элементами форматирования, которые соответствуют объекту в списке параметров этого метода. Процесс форматирования заменяет каждый элемент форматирования строковым представлением значения соответствующего объекта.
Синтаксис элемента форматирования выглядит следующим образом:
{index[,length][:formatString]}
Элементы в квадратных скобках являются необязательными. Каждый из элементов описан в таблице ниже. Дополнительные сведения о функции составного форматирования, включая синтаксис элемента форматирования, см. в разделе Составное форматирование.
Элемент | Описание |
---|---|
index | Отсчитываемая от нуля позиция в списке параметров отформатированного объекта. Если объект, заданный индексом , имеет значение null , элемент форматирования заменяется String.Emptyна . Так как эта перегрузка содержит массив в списке параметров, значение индекса всегда должно быть меньше длины массива. Если в позиции индекса нет параметра, FormatException возникает исключение . |
, длина | Минимальное количество символов в строковом представлении параметра. При положительном значении параметр выравнивается по правому краю; Если значение отрицательное, оно выравнивается по левому краю. |
:formatString | Строка стандартного или настраиваемого формата, поддерживаемая отформатированным объектом. Возможные значения formatString совпадают со значениями, поддерживаемыми методом объекта ToString(string format) . Если аргумент formatString не указан и отформатированный объект реализует IFormattable интерфейс , null передается в качестве значения параметра, используемого format в качестве строки форматирования IFormattable.ToString . |
Начальные и конечные фигурные скобки , "{" и "}", являются обязательными. Чтобы указать один литеральный символ скобок в format
, укажите две начальные или конечные фигурные скобки, то есть "{{" или "}}".
Этот метод не выполняет поиск отдельных символов перехода на новую строку (шестнадцатеричное представление 0x000a) в указанной строке и не заменяет их значением свойства TextWriter.NewLine.
Если указанный объект не указан в строке формата, он игнорируется.
Список распространенных задач ввода-вывода см. в разделе Общие задачи ввода-вывода.
См. также раздел
- StreamWriter
- StringWriter
- IFormatProvider
- Файловый и потоковый ввод-вывод
- Практическое руководство. Чтение текста из файла
- Практическое руководство. Запись текста в файл
Применяется к
Write(String, Object)
- Исходный код:
- TextWriter.cs
- Исходный код:
- TextWriter.cs
- Исходный код:
- TextWriter.cs
Записывает форматированную строку в текстовый поток, используя ту же семантику, что и метод Format(String, Object).
public:
virtual void Write(System::String ^ format, System::Object ^ arg0);
public virtual void Write (string format, object arg0);
public virtual void Write (string format, object? arg0);
abstract member Write : string * obj -> unit
override this.Write : string * obj -> unit
Public Overridable Sub Write (format As String, arg0 As Object)
Параметры
- format
- String
Строка составного формата.
- arg0
- Object
Объект для форматирования и записи.
Исключения
format
имеет значение null
.
Объект TextWriter закрыт.
Ошибка ввода-вывода.
Параметр format
не является допустимой строкой составного формата.
-или-
Индекс элемента формата меньше 0 (нуля) или больше или равен числу объектов, которые необходимо отформатировать (которое для этой перегрузки метода равно 1).
Комментарии
Этот метод использует составное форматирование для преобразования значения объекта в его строковое представление и для внедрения этого представления в строку. .NET предоставляет расширенную поддержку форматирования, которая более подробно описана в следующих разделах:
Дополнительные сведения о функции составного форматирования см. в разделе Составное форматирование.
Дополнительные сведения об описателях числовых форматов см. в разделах Строки стандартного числового формата и Строки настраиваемого числового формата.
Дополнительные сведения об описателях формата даты и времени см. в разделах Стандартные строки формата даты и времени и Настраиваемые строки формата даты и времени.
Дополнительные сведения об описателях формата перечисления см. в разделе Строки формата перечисления.
Дополнительные сведения о форматировании см. в разделе Типы форматирования.
Параметр format
состоит из нуля или более выполнений текста, перемешанных с нулевым или несколькими индексированных заполнителей, называемых элементами форматирования, которые соответствуют объекту в списке параметров этого метода. Процесс форматирования заменяет каждый элемент форматирования строковым представлением значения соответствующего объекта.
Синтаксис элемента форматирования выглядит следующим образом:
{index[,length][:formatString]}
Элементы в квадратных скобках являются необязательными. Каждый из элементов описан в таблице ниже. Дополнительные сведения о функции составного форматирования, включая синтаксис элемента форматирования, см. в разделе Составное форматирование.
Элемент | Описание |
---|---|
index | Отсчитываемая от нуля позиция в списке параметров отформатированного объекта. Если объект, заданный индексом , имеет значение null , элемент форматирования заменяется String.Emptyна . Так как эта перегрузка содержит только один объект в списке параметров, значение индекса всегда должно быть равно 0. Если в позиции индекса нет параметра, FormatException возникает исключение . |
, длина | Минимальное количество символов в строковом представлении параметра. При положительном значении параметр выравнивается по правому краю; Если значение отрицательное, оно выравнивается по левому краю. |
:formatString | Строка стандартного или настраиваемого формата, поддерживаемая отформатированным объектом. Возможные значения formatString совпадают со значениями, поддерживаемыми методом объекта ToString(string format) . Если аргумент formatString не указан и отформатированный объект реализует IFormattable интерфейс , null передается в качестве значения параметра, используемого format в качестве строки форматирования IFormattable.ToString . |
Начальные и конечные фигурные скобки , "{" и "}", являются обязательными. Чтобы указать один литеральный символ скобок в format
, укажите две начальные или конечные фигурные скобки, то есть "{{" или "}}".
Этот метод не выполняет поиск отдельных символов перехода на новую строку (шестнадцатеричное представление 0x000a) в указанной строке и не заменяет их значением свойства TextWriter.NewLine.
Если указанный объект не указан в строке формата, он игнорируется.
Список распространенных задач ввода-вывода см. в разделе Общие задачи ввода-вывода.
См. также раздел
- StreamWriter
- StringWriter
- IFormatProvider
- Файловый и потоковый ввод-вывод
- Практическое руководство. Чтение текста из файла
- Практическое руководство. Запись текста в файл
Применяется к
Write(UInt64)
- Исходный код:
- TextWriter.cs
- Исходный код:
- TextWriter.cs
- Исходный код:
- TextWriter.cs
Важно!
Этот API несовместим с CLS.
Записывает в текстовый поток текстовое представление целого числа без знака размером 8 байт.
public:
virtual void Write(System::UInt64 value);
[System.CLSCompliant(false)]
public virtual void Write (ulong value);
[<System.CLSCompliant(false)>]
abstract member Write : uint64 -> unit
override this.Write : uint64 -> unit
Public Overridable Sub Write (value As ULong)
Параметры
- value
- UInt64
Записываемое целое число без знака размером 8 байт.
- Атрибуты
Исключения
Объект TextWriter закрыт.
Ошибка ввода-вывода.
Комментарии
Текстовое представление указанного значения создается путем UInt64.ToString вызова метода . Свойство TextWriter.FormatProvider , если нет null
, указывает форматирование, зависят от языка и региональных параметров.
Список распространенных задач ввода-вывода см. в разделе Общие задачи ввода-вывода.
См. также раздел
- StreamWriter
- StringWriter
- IFormatProvider
- Файловый и потоковый ввод-вывод
- Практическое руководство. Чтение текста из файла
- Практическое руководство. Запись текста в файл
Применяется к
Write(UInt32)
- Исходный код:
- TextWriter.cs
- Исходный код:
- TextWriter.cs
- Исходный код:
- TextWriter.cs
Важно!
Этот API несовместим с CLS.
Записывает в текстовый поток текстовое представление целого числа без знака размером 4 байта.
public:
virtual void Write(System::UInt32 value);
[System.CLSCompliant(false)]
public virtual void Write (uint value);
[<System.CLSCompliant(false)>]
abstract member Write : uint32 -> unit
override this.Write : uint32 -> unit
Public Overridable Sub Write (value As UInteger)
Параметры
- value
- UInt32
Записываемое целое число без знака размером 4 байта.
- Атрибуты
Исключения
Объект TextWriter закрыт.
Ошибка ввода-вывода.
Комментарии
Текстовое представление указанного значения создается путем UInt32.ToString вызова метода . Свойство TextWriter.FormatProvider , если нет null
, задает форматирование, зависят от языка и региональных параметров.
Список распространенных задач ввода-вывода см. в разделе Общие задачи ввода-вывода.
См. также раздел
- StreamWriter
- StringWriter
- IFormatProvider
- Файловый и потоковый ввод-вывод
- Практическое руководство. Чтение текста из файла
- Практическое руководство. Запись текста в файл
Применяется к
Write(StringBuilder)
- Исходный код:
- TextWriter.cs
- Исходный код:
- TextWriter.cs
- Исходный код:
- TextWriter.cs
Записывает построитель строки в текстовый поток.
public:
virtual void Write(System::Text::StringBuilder ^ value);
public virtual void Write (System.Text.StringBuilder? value);
abstract member Write : System.Text.StringBuilder -> unit
override this.Write : System.Text.StringBuilder -> unit
Public Overridable Sub Write (value As StringBuilder)
Параметры
- value
- StringBuilder
Строка как построитель строки для записи в текстовый поток.
Комментарии
Этот метод эквивалентен Write(stringBuilder.ToString())
, но использует метод , StringBuilder.GetChunks чтобы избежать создания промежуточной строки.
Применяется к
Write(String)
- Исходный код:
- TextWriter.cs
- Исходный код:
- TextWriter.cs
- Исходный код:
- TextWriter.cs
Асинхронно записывает строку в текстовый поток.
public:
virtual void Write(System::String ^ value);
public virtual void Write (string value);
public virtual void Write (string? value);
abstract member Write : string -> unit
override this.Write : string -> unit
Public Overridable Sub Write (value As String)
Параметры
- value
- String
Строка для записи.
Исключения
Объект TextWriter закрыт.
Ошибка ввода-вывода.
Комментарии
Эта перегрузка эквивалентна перегрузке Write(Char[]) .
Этот метод не выполняет поиск отдельных символов перехода на новую строку (шестнадцатеричное представление 0x000a) в указанной строке и не заменяет их значением свойства TextWriter.NewLine.
Если параметр value
имеет значение null
, в текстовый поток ничего не записывается.
Список распространенных задач ввода-вывода см. в разделе Общие задачи ввода-вывода.
См. также раздел
- Write(String)
- Write(String)
- Файловый и потоковый ввод-вывод
- Практическое руководство. Чтение текста из файла
- Практическое руководство. Запись текста в файл
Применяется к
Write(Single)
- Исходный код:
- TextWriter.cs
- Исходный код:
- TextWriter.cs
- Исходный код:
- TextWriter.cs
Записывает в текстовый поток текстовое представление значения с плавающей запятой размером 4 байта.
public:
virtual void Write(float value);
public virtual void Write (float value);
abstract member Write : single -> unit
override this.Write : single -> unit
Public Overridable Sub Write (value As Single)
Параметры
- value
- Single
Записываемое значение с плавающей запятой размером 4 байта.
Исключения
Объект TextWriter закрыт.
Ошибка ввода-вывода.
Комментарии
Текстовое представление указанного значения создается путем Single.ToString вызова метода . Свойство TextWriter.FormatProvider , если нет null
, задает форматирование, зависят от языка и региональных параметров.
Список распространенных задач ввода-вывода см. в разделе Общие задачи ввода-вывода.
См. также раздел
- StreamWriter
- StringWriter
- IFormatProvider
- Файловый и потоковый ввод-вывод
- Практическое руководство. Чтение текста из файла
- Практическое руководство. Запись текста в файл
Применяется к
Write(String, Object, Object)
- Исходный код:
- TextWriter.cs
- Исходный код:
- TextWriter.cs
- Исходный код:
- TextWriter.cs
Записывает форматированную строку в текстовый поток, используя ту же семантику, что и метод Format(String, Object, Object).
public:
virtual void Write(System::String ^ format, System::Object ^ arg0, System::Object ^ arg1);
public virtual void Write (string format, object arg0, object arg1);
public virtual void Write (string format, object? arg0, object? arg1);
abstract member Write : string * obj * obj -> unit
override this.Write : string * obj * obj -> unit
Public Overridable Sub Write (format As String, arg0 As Object, arg1 As Object)
Параметры
- format
- String
Строка составного формата.
- arg0
- Object
Первый объект для форматирования и записи.
- arg1
- Object
Второй объект для форматирования и записи.
Исключения
format
имеет значение null
.
Объект TextWriter закрыт.
Ошибка ввода-вывода.
Параметр format
не является допустимой строкой составного формата.
-или-
Индекс элемента формата меньше 0 (нуля) или больше или равен числу объектов, которые необходимо отформатировать (которое для этой перегрузки метода равно 2).
Комментарии
Этот метод использует составное форматирование для преобразования значения объекта в его строковое представление и для внедрения этого представления в строку. .NET предоставляет обширную поддержку форматирования, которая более подробно описана в следующих разделах форматирования:
Дополнительные сведения о функции составного форматирования см. в разделе Составное форматирование.
Дополнительные сведения об описателях числовых форматов см. в разделах Строки стандартного числового формата и Строки пользовательского числового формата.
Дополнительные сведения об описателях формата даты и времени см. в разделах Стандартные строки формата даты и времени и Настраиваемые строки формата даты и времени.
Дополнительные сведения об описателях формата перечисления см. в разделе Строки формата перечисления.
Дополнительные сведения о форматировании см. в разделе Типы форматирования.
Параметр format
состоит из нуля или более выполнений текста, перемешанных с нулем или более индексированных заполнителей, называемых элементами формата, которые соответствуют объекту в списке параметров этого метода. Процесс форматирования заменяет каждый элемент форматирования строковым представлением значения соответствующего объекта.
Синтаксис элемента форматирования выглядит следующим образом:
{index[,length][:formatString]}
Элементы в квадратных скобках являются необязательными. Каждый из элементов описан в таблице ниже. Дополнительные сведения о функции составного форматирования, включая синтаксис элемента форматирования, см. в разделе Составное форматирование.
Элемент | Описание |
---|---|
index | Отсчитываемая от нуля позиция в списке параметров отформатированного объекта. Если объект, заданный индексом , имеет значение null , элемент формата заменяется String.Emptyна . Так как эта перегрузка содержит два объекта в списке параметров, значение индекса всегда должно быть равно 0 или 1. Если в позиции индекса нет параметра, FormatException создается исключение . |
, длина | Минимальное число символов в строковом представлении параметра. Если положительный результат, параметр выравнивается по правому краю; Если отрицательный, он выравнивается по левому краю. |
:formatString | Строка стандартного или настраиваемого формата, поддерживаемая отформатированным объектом. Возможные значения для formatString совпадают со значениями, поддерживаемыми методом объекта ToString(string format) . Если formatString не указан, а отформатированный объект реализует IFormattable интерфейс, null передается в качестве значения параметра, используемого format в качестве строки форматирования IFormattable.ToString . |
Требуются начальные и конечные символы фигурных скобок : "{" и "}". Чтобы указать один литеральный символ фигурной скобки в format
, укажите два начальных или конечных символа скобки, т. е. "{{" или "}}".
Этот метод не выполняет поиск отдельных символов перехода на новую строку (шестнадцатеричное представление 0x000a) в указанной строке и не заменяет их значением свойства TextWriter.NewLine.
Если указанный объект не указан в строке формата, он игнорируется.
Список распространенных задач ввода-вывода см. в разделе Общие задачи ввода-вывода.
См. также раздел
- StreamWriter
- StringWriter
- IFormatProvider
- Файловый и потоковый ввод-вывод
- Практическое руководство. Чтение текста из файла
- Практическое руководство. Запись текста в файл
Применяется к
Write(Object)
- Исходный код:
- TextWriter.cs
- Исходный код:
- TextWriter.cs
- Исходный код:
- TextWriter.cs
Записывает в текстовый поток текстовое представление объекта с помощью вызова метода ToString
для этого объекта.
public:
virtual void Write(System::Object ^ value);
public virtual void Write (object value);
public virtual void Write (object? value);
abstract member Write : obj -> unit
override this.Write : obj -> unit
Public Overridable Sub Write (value As Object)
Параметры
- value
- Object
Записываемый объект.
Исключения
Объект TextWriter закрыт.
Ошибка ввода-вывода.
Комментарии
Эта перегрузка эквивалентна перегрузке Write(String) .
Если указанный объект имеет значение null
, никаких действий не выполняется и исключение не создается. В противном случае вызывается метод объекта ToString
для создания строкового представления, а результирующая строка записывается в выходной поток. Свойство FormatProvider , если нет null
, задает форматирование, зависят от языка и региональных параметров.
Список распространенных задач ввода-вывода см. в разделе Общие задачи ввода-вывода.
См. также раздел
- StreamWriter
- StringWriter
- IFormatProvider
- Файловый и потоковый ввод-вывод
- Практическое руководство. Чтение текста из файла
- Практическое руководство. Запись текста в файл
Применяется к
Write(Int64)
- Исходный код:
- TextWriter.cs
- Исходный код:
- TextWriter.cs
- Исходный код:
- TextWriter.cs
Записывает в текстовый поток текстовое представление целого числа со знаком размером 8 байт.
public:
virtual void Write(long value);
public virtual void Write (long value);
abstract member Write : int64 -> unit
override this.Write : int64 -> unit
Public Overridable Sub Write (value As Long)
Параметры
- value
- Int64
Записываемое целое число со знаком размером 8 байт.
Исключения
Объект TextWriter закрыт.
Ошибка ввода-вывода.
Комментарии
Текстовое представление указанного значения создается путем Int64.ToString вызова метода . Свойство TextWriter.FormatProvider , если нет null
, указывает форматирование, зависят от языка и региональных параметров.
Список распространенных задач ввода-вывода см. в разделе Общие задачи ввода-вывода.
Практическое руководство. Запись текста в файл
См. также раздел
Применяется к
Write(Int32)
- Исходный код:
- TextWriter.cs
- Исходный код:
- TextWriter.cs
- Исходный код:
- TextWriter.cs
Записывает в текстовый поток текстовое представление целого числа со знаком размером 4 байта.
public:
virtual void Write(int value);
public virtual void Write (int value);
abstract member Write : int -> unit
override this.Write : int -> unit
Public Overridable Sub Write (value As Integer)
Параметры
- value
- Int32
Записываемое целое число со знаком размером 4 байта.
Исключения
Объект TextWriter закрыт.
Ошибка ввода-вывода.
Комментарии
Текстовое представление указанного значения создается путем Int32.ToString вызова метода . Свойство TextWriter.FormatProvider , если нет null
, указывает форматирование, зависят от языка и региональных параметров.
Список распространенных задач ввода-вывода см. в разделе Общие задачи ввода-вывода.
См. также раздел
- StreamWriter
- StringWriter
- IFormatProvider
- Файловый и потоковый ввод-вывод
- Практическое руководство. Чтение текста из файла
- Практическое руководство. Запись текста в файл
Применяется к
Write(Double)
- Исходный код:
- TextWriter.cs
- Исходный код:
- TextWriter.cs
- Исходный код:
- TextWriter.cs
Записывает в текстовый поток текстовое представление значения с плавающей запятой размером 8 байт.
public:
virtual void Write(double value);
public virtual void Write (double value);
abstract member Write : double -> unit
override this.Write : double -> unit
Public Overridable Sub Write (value As Double)
Параметры
- value
- Double
Записываемое значение с плавающей запятой размером 8 байт.
Исключения
Объект TextWriter закрыт.
Ошибка ввода-вывода.
Комментарии
Текстовое представление указанного значения создается путем Double.ToString вызова метода . Свойство TextWriter.FormatProvider , если нет null
, указывает форматирование, зависят от языка и региональных параметров.
Список распространенных задач ввода-вывода см. в разделе Общие задачи ввода-вывода.
См. также раздел
- StreamWriter
- StringWriter
- IFormatProvider
- Файловый и потоковый ввод-вывод
- Практическое руководство. Чтение текста из файла
- Практическое руководство. Запись текста в файл
Применяется к
Write(Decimal)
- Исходный код:
- TextWriter.cs
- Исходный код:
- TextWriter.cs
- Исходный код:
- TextWriter.cs
Записывает текстовое представление десятичного значения в текстовый поток.
public:
virtual void Write(System::Decimal value);
public virtual void Write (decimal value);
abstract member Write : decimal -> unit
override this.Write : decimal -> unit
Public Overridable Sub Write (value As Decimal)
Параметры
- value
- Decimal
Десятичное значение, которое необходимо записать.
Исключения
Объект TextWriter закрыт.
Ошибка ввода-вывода.
Комментарии
Свойство FormatProvider , если нет null
, указывает форматирование, зависят от языка и региональных параметров.
См. также раздел
- StreamWriter
- StringWriter
- IFormatProvider
- Файловый и потоковый ввод-вывод
- Практическое руководство. Чтение текста из файла
- Практическое руководство. Запись текста в файл
Применяется к
Write(Char[])
- Исходный код:
- TextWriter.cs
- Исходный код:
- TextWriter.cs
- Исходный код:
- TextWriter.cs
Записывает массив символов в текстовый поток.
public:
virtual void Write(cli::array <char> ^ buffer);
public virtual void Write (char[] buffer);
public virtual void Write (char[]? buffer);
abstract member Write : char[] -> unit
override this.Write : char[] -> unit
Public Overridable Sub Write (buffer As Char())
Параметры
- buffer
- Char[]
Массив символов, записываемый в текстовый поток.
Исключения
Объект TextWriter закрыт.
Ошибка ввода-вывода.
Комментарии
Этот метод не выполняет поиск отдельных символов перехода на новую строку (шестнадцатеричное представление 0x000a) в указанной строке и не заменяет их значением свойства NewLine.
Этот метод по умолчанию вызывает Write(Char[], Int32, Int32) метод и передает весь массив символов. Если массив символов имеет значение null
, ничего не записывается.
Список распространенных задач ввода-вывода см. в разделе Общие задачи ввода-вывода.
См. также раздел
- Write(Char[])
- Файловый и потоковый ввод-вывод
- Практическое руководство. Чтение текста из файла
- Практическое руководство. Запись текста в файл
Применяется к
Write(Char)
- Исходный код:
- TextWriter.cs
- Исходный код:
- TextWriter.cs
- Исходный код:
- TextWriter.cs
Записывает символ в текстовый поток.
public:
abstract void Write(char value);
public:
virtual void Write(char value);
public abstract void Write (char value);
public virtual void Write (char value);
abstract member Write : char -> unit
abstract member Write : char -> unit
override this.Write : char -> unit
Public MustOverride Sub Write (value As Char)
Public Overridable Sub Write (value As Char)
Параметры
- value
- Char
Символ, записываемый в текстовый поток.
Исключения
Объект TextWriter закрыт.
Ошибка ввода-вывода.
Комментарии
Этот метод по умолчанию ничего не делает, но производные классы могут переопределить метод для предоставления соответствующей функциональности.
Список распространенных задач ввода-вывода см. в разделе Общие задачи ввода-вывода.
См. также раздел
- Write(Char)
- Write(Char)
- Файловый и потоковый ввод-вывод
- Практическое руководство. Чтение текста из файла
- Практическое руководство. Запись текста в файл
Применяется к
Write(Boolean)
- Исходный код:
- TextWriter.cs
- Исходный код:
- TextWriter.cs
- Исходный код:
- TextWriter.cs
Записывает текстовое представление значения типа Boolean
в текстовый поток.
public:
virtual void Write(bool value);
public virtual void Write (bool value);
abstract member Write : bool -> unit
override this.Write : bool -> unit
Public Overridable Sub Write (value As Boolean)
Параметры
- value
- Boolean
Значение Boolean
для записи.
Исключения
Объект TextWriter закрыт.
Ошибка ввода-вывода.
Комментарии
Текстовое представление указанного значения создается путем Boolean.ToString вызова метода .
Этот метод выводит или Boolean.TrueStringBoolean.FalseString.
Список распространенных задач ввода-вывода см. в разделе Общие задачи ввода-вывода.
См. также раздел
- StreamWriter
- StringWriter
- Файловый и потоковый ввод-вывод
- Практическое руководство. Чтение текста из файла
- Практическое руководство. Запись текста в файл
Применяется к
Write(ReadOnlySpan<Char>)
- Исходный код:
- TextWriter.cs
- Исходный код:
- TextWriter.cs
- Исходный код:
- TextWriter.cs
Записывает диапазон символов в текстовый поток.
public:
virtual void Write(ReadOnlySpan<char> buffer);
public virtual void Write (ReadOnlySpan<char> buffer);
abstract member Write : ReadOnlySpan<char> -> unit
override this.Write : ReadOnlySpan<char> -> unit
Public Overridable Sub Write (buffer As ReadOnlySpan(Of Char))
Параметры
- buffer
- ReadOnlySpan<Char>
Записываемый диапазон символов.
Комментарии
Текстовое представление указанного значения создается путем вызова readOnlySpan<Char>. Метод ToString .
Список распространенных задач ввода-вывода см. в разделе Общие задачи ввода-вывода.
Применяется к
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по