TextWriter.Write Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Записывает данные в текстовый поток.
Перегрузки
Write(String, Object, Object, Object) |
Записывает форматированную строку в текстовый поток, используя ту же семантику, что и метод Format(String, Object, Object, Object). |
Write(Char[], Int32, Int32) |
Записывает вложенные символы в текстовый поток. |
Write(String, ReadOnlySpan<Object>) |
Записывает форматированную строку в текстовый поток, используя ту же семантику, что и Format(String, ReadOnlySpan<Object>). |
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 (ноль) или больше или равен числу объектов, отформатированных (для перегрузки этого метода — три).
Комментарии
Этот метод использует составное форматирование для преобразования значения объекта в строковое представление и внедрения этого представления в строку. .NET предоставляет обширную поддержку форматирования, которая подробно описана в следующих разделах форматирования:
Дополнительные сведения о функции составного форматирования см. в составныхформатирования.
Дополнительные сведения об описателях числовых форматов см. в строках стандартного числового формата и пользовательских строк числовых форматов.
Дополнительные сведения о описателях формата даты и времени см. в строках стандартного формата даты и времени и настраиваемых строк формата даты и времени.
Дополнительные сведения об описателях формата перечисления см. в строках формата перечисления.
Дополнительные сведения о форматировании см. в типов форматирования.
Параметр format
состоит из нуля или нескольких запусков текста, пересекающихся с нуля или более индексированных заполнителей, называемых элементами форматирования, которые соответствуют объекту в списке параметров этого метода. Процесс форматирования заменяет каждый элемент формата строковым представлением значения соответствующего объекта.
Синтаксис элемента формата выглядит следующим образом:
{индекс[,длина][:formatString]}
Элементы в квадратных скобках являются необязательными. В следующей таблице описан каждый элемент. Дополнительные сведения о функции составного форматирования, включая синтаксис элемента форматирования, см. в составной.
Элемент | Описание |
---|---|
индекс | Отсчитываемая от нуля позиция в списке параметров объекта, который необходимо отформатировать. Если объект, указанный индексом, 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[]) для каждого символа в buffer
между index
и (index
+ count
).
Список распространенных задач ввода-вывода см. в разделе Распространенные задачи ввода-вывода.
См. также раздел
- Write(Char[], Int32, Int32)
- Write(Char[], Int32, Int32)
- файлов и потоковой ввода-вывода
- Практическое руководство. Чтение текста из файла
- Практическое руководство. Запись текста в файл
Применяется к
Write(String, ReadOnlySpan<Object>)
Записывает форматированную строку в текстовый поток, используя ту же семантику, что и Format(String, ReadOnlySpan<Object>).
public:
virtual void Write(System::String ^ format, ReadOnlySpan<System::Object ^> arg);
public virtual void Write (string format, scoped ReadOnlySpan<object?> arg);
abstract member Write : string * ReadOnlySpan<obj> -> unit
override this.Write : string * ReadOnlySpan<obj> -> unit
Public Overridable Sub Write (format As String, arg As ReadOnlySpan(Of Object))
Параметры
- format
- String
Строка составного формата.
- arg
- ReadOnlySpan<Object>
Диапазон объектов, содержащий ноль или больше объектов для форматирования и записи.
Применяется к
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
не является допустимой строкой составного формата.
-или-
Индекс элемента формата меньше 0 (ноль) или больше или равен длине массива arg
.
Комментарии
Этот метод использует составное форматирование для преобразования значения объекта в строковое представление и внедрения этого представления в строку. .NET предоставляет обширную поддержку форматирования, которая подробно описана в следующих разделах форматирования:
Дополнительные сведения о функции составного форматирования см. в составныхформатирования.
Дополнительные сведения об описателях числовых форматов см. в строках стандартного числового формата и пользовательских строк числовых форматов.
Дополнительные сведения о описателях формата даты и времени см. в строках стандартного формата даты и времени и настраиваемых строк формата даты и времени.
Дополнительные сведения об описателях формата перечисления см. в строках формата перечисления.
Дополнительные сведения о форматировании см. в типов форматирования.
Параметр format
состоит из нуля или нескольких запусков текста, пересекающихся с нуля или более индексированных заполнителей, называемых элементами форматирования, которые соответствуют объекту в списке параметров этого метода. Процесс форматирования заменяет каждый элемент формата строковым представлением значения соответствующего объекта.
Синтаксис элемента формата выглядит следующим образом:
{индекс[,длина][:formatString]}
Элементы в квадратных скобках являются необязательными. В следующей таблице описан каждый элемент. Дополнительные сведения о функции составного форматирования, включая синтаксис элемента форматирования, см. в составной.
Элемент | Описание |
---|---|
индекс | Отсчитываемая от нуля позиция в списке параметров объекта, который необходимо отформатировать. Если объект, указанный индексом, 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 (ноль) или больше или равен числу объектов, отформатированных (которое для перегрузки этого метода является одним).
Комментарии
Этот метод использует составное форматирование для преобразования значения объекта в строковое представление и внедрения этого представления в строку. .NET предоставляет обширную поддержку форматирования, которая подробно описана в следующих разделах форматирования:
Дополнительные сведения о функции составного форматирования см. в составныхформатирования.
Дополнительные сведения об описателях числовых форматов см. в строках стандартного числового формата и пользовательских строк числовых форматов.
Дополнительные сведения о описателях формата даты и времени см. в строках стандартного формата даты и времени и настраиваемых строк формата даты и времени.
Дополнительные сведения об описателях формата перечисления см. в строках формата перечисления.
Дополнительные сведения о форматировании см. в типов форматирования.
Параметр format
состоит из нуля или нескольких запусков текста, пересекающихся с нуля или более индексированных заполнителей, называемых элементами форматирования, которые соответствуют объекту в списке параметров этого метода. Процесс форматирования заменяет каждый элемент формата строковым представлением значения соответствующего объекта.
Синтаксис элемента формата выглядит следующим образом:
{индекс[,длина][:formatString]}
Элементы в квадратных скобках являются необязательными. В следующей таблице описан каждый элемент. Дополнительные сведения о функции составного форматирования, включая синтаксис элемента форматирования, см. в составной.
Элемент | Описание |
---|---|
индекс | Отсчитываемая от нуля позиция в списке параметров объекта, который необходимо отформатировать. Если объект, указанный индексом, 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 (ноль) или больше или равен числу объектов, отформатированных (которое для перегрузки этого метода равно двум).
Комментарии
Этот метод использует составное форматирование для преобразования значения объекта в строковое представление и внедрения этого представления в строку. .NET предоставляет обширную поддержку форматирования, которая подробно описана в следующих разделах форматирования:
Дополнительные сведения о функции составного форматирования см. в составныхформатирования.
Дополнительные сведения об описателях числовых форматов см. в строках стандартного числового формата и пользовательских строк числовых форматов.
Дополнительные сведения о описателях формата даты и времени см. в строках стандартного формата даты и времени и настраиваемых строк формата даты и времени.
Дополнительные сведения об описателях формата перечисления см. в строках формата перечисления.
Дополнительные сведения о форматировании см. в типов форматирования.
Параметр format
состоит из нуля или нескольких запусков текста, пересекающихся с нуля или более индексированных заполнителей, называемых элементами форматирования, которые соответствуют объекту в списке параметров этого метода. Процесс форматирования заменяет каждый элемент формата строковым представлением значения соответствующего объекта.
Синтаксис элемента формата выглядит следующим образом:
{индекс[,длина][:formatString]}
Элементы в квадратных скобках являются необязательными. В следующей таблице описан каждый элемент. Дополнительные сведения о функции составного форматирования, включая синтаксис элемента форматирования, см. в составной.
Элемент | Описание |
---|---|
индекс | Отсчитываемая от нуля позиция в списке параметров объекта, который необходимо отформатировать. Если объект, указанный индексом, 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.TrueString или Boolean.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 как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по