TextWriter.Write TextWriter.Write TextWriter.Write TextWriter.Write Method

Определение

Записывает данные в текстовый поток.Writes data to a text stream.

Перегрузки

Write(String, Object, Object) Write(String, Object, Object) Write(String, Object, Object) Write(String, Object, Object)

Записывает форматированную строку в текстовый поток, используя ту же семантику, что и метод Format(String, Object, Object).Writes a formatted string to the text stream using the same semantics as the Format(String, Object, Object) method.

Write(Char[], Int32, Int32) Write(Char[], Int32, Int32) Write(Char[], Int32, Int32) Write(Char[], Int32, Int32)

Записывает подмассив символов в текстовый поток.Writes a subarray of characters to the text stream.

Write(String, Object[]) Write(String, Object[]) Write(String, Object[]) Write(String, Object[])

Записывает форматированную строку в текстовый поток, используя ту же семантику, что и метод Format(String, Object[]).Writes a formatted string to the text stream, using the same semantics as the Format(String, Object[]) method.

Write(String, Object) Write(String, Object) Write(String, Object) Write(String, Object)

Записывает форматированную строку в текстовый поток, используя ту же семантику, что и метод Format(String, Object).Writes a formatted string to the text stream, using the same semantics as the Format(String, Object) method.

Write(UInt64) Write(UInt64) Write(UInt64) Write(UInt64)

Записывает в текстовый поток текстовое представление целого числа без знака размером 8 байт.Writes the text representation of an 8-byte unsigned integer to the text stream.

Write(UInt32) Write(UInt32) Write(UInt32) Write(UInt32)

Записывает в текстовый поток текстовое представление целого числа без знака размером 4 байта.Writes the text representation of a 4-byte unsigned integer to the text stream.

Write(StringBuilder) Write(StringBuilder) Write(StringBuilder) Write(StringBuilder)

Записывает построитель строки в текстовый поток.Writes a string builder to the text stream.

Write(String) Write(String) Write(String) Write(String)

Асинхронно записывает строку в текстовый поток.Writes a string to the text stream.

Write(Single) Write(Single) Write(Single) Write(Single)

Записывает в текстовый поток текстовое представление значения с плавающей запятой размером 4 байта.Writes the text representation of a 4-byte floating-point value to the text stream.

Write(String, Object, Object, Object) Write(String, Object, Object, Object) Write(String, Object, Object, Object) Write(String, Object, Object, Object)

Записывает форматированную строку в текстовый поток, используя ту же семантику, что и метод Format(String, Object, Object, Object).Writes a formatted string to the text stream, using the same semantics as the Format(String, Object, Object, Object) method.

Write(Object) Write(Object) Write(Object) Write(Object)

Записывает в текстовый поток текстовое представление объекта с помощью вызова метода ToString для этого объекта.Writes the text representation of an object to the text stream by calling the ToString method on that object.

Write(Int64) Write(Int64) Write(Int64) Write(Int64)

Записывает в текстовый поток текстовое представление целого числа со знаком размером 8 байт.Writes the text representation of an 8-byte signed integer to the text stream.

Write(Int32) Write(Int32) Write(Int32) Write(Int32)

Записывает в текстовый поток текстовое представление целого числа со знаком размером 4 байта.Writes the text representation of a 4-byte signed integer to the text stream.

Write(Double) Write(Double) Write(Double) Write(Double)

Записывает в текстовый поток текстовое представление значения с плавающей запятой размером 8 байт.Writes the text representation of an 8-byte floating-point value to the text stream.

Write(Decimal) Write(Decimal) Write(Decimal) Write(Decimal)

Записывает текстовое представление десятичного значения в текстовый поток.Writes the text representation of a decimal value to the text stream.

Write(Char[]) Write(Char[]) Write(Char[]) Write(Char[])

Записывает массив символов в текстовый поток.Writes a character array to the text stream.

Write(Char) Write(Char) Write(Char) Write(Char)

Записывает символ в текстовый поток.Writes a character to the text stream.

Write(Boolean) Write(Boolean) Write(Boolean) Write(Boolean)

Записывает текстовое представление значения типа Boolean в текстовый поток.Writes the text representation of a Boolean value to the text stream.

Write(ReadOnlySpan<Char>) Write(ReadOnlySpan<Char>) Write(ReadOnlySpan<Char>) Write(ReadOnlySpan<Char>)

Записывает диапазон символов в текстовый поток.Writes a character span to the text stream.

Write(String, Object, Object) Write(String, Object, Object) Write(String, Object, Object) Write(String, Object, Object)

Записывает форматированную строку в текстовый поток, используя ту же семантику, что и метод Format(String, Object, Object).Writes a formatted string to the text stream using the same semantics as the Format(String, Object, Object) method.

public:
 virtual void Write(System::String ^ format, System::Object ^ arg0, System::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 String String String

Строка составного формата.A composite format string.

arg0
Object Object Object Object

Первый объект для форматирования и записи.The first object to format and write.

arg1
Object Object Object Object

Второй объект для форматирования и записи.The second object to format and write.

Исключения

Ошибка ввода-вывода.An I/O error occurs.

Параметр format не является допустимой строкой составного формата.format is not a valid composite format string.

- или --or- Индекс элемента формата меньше 0 (нуля) или больше или равен числу объектов, которые необходимо отформатировать (которое для этой перегрузки метода равно 2).The index of a format item is less than 0 (zero) or greater than or equal to the number of objects to be formatted (which, for this method overload, is two).

Комментарии

Этот метод использует составное форматирование для преобразования значения объекта в строковое представление и для внедрения этого представления в строку.This method uses composite formatting to convert the value of an object to its string representation and to embed that representation in a string. .NET обеспечивает обширную поддержку форматирования, которая подробно описывается в следующих разделах форматирования:.NET provides extensive formatting support, which is described in greater detail in the following formatting topics:

format Параметр содержит ноль или более фрагментов текста, которые пересмешиваются с нулевым или более индексированными заполнителями, называемыми элементами форматирования, которые соответствуют объекту в списке параметров этого метода.The format parameter consists of zero or more runs of text intermixed with zero or more indexed placeholders, called format items, that correspond to an object in the parameter list of this method. Процесс форматирования заменяет каждый элемент форматирования строковым представлением значения соответствующего объекта.The formatting process replaces each format item with the string representation of the value of the corresponding object.

Синтаксис элемента форматирования выглядит следующим образом:The syntax of a format item is as follows:

{index[,length] [:FormatString]}{index[,length][:formatString]}

Элементы в квадратных скобках являются необязательными.Elements in square brackets are optional. Каждый из элементов описан в таблице ниже.The following table describes each element. Дополнительные сведения о функции составного форматирования, включая синтаксис элемента форматирования, см. в разделе составное форматирование.For more information about the composite formatting feature, including the syntax of a format item, see Composite Formatting.

ЭлементElement ОписаниеDescription
индексindex Отсчитываемая от нуля координата в списке параметров объекта для форматирования.The zero-based position in the parameter list of the object to be formatted. Если объект, указанный в ** параметре nullindex, имеет значение, то элемент String.Emptyформатирования заменяется на.If the object specified by index is null, the format item is replaced by String.Empty. Поскольку эта перегрузка содержит два объекта в списке параметров, значение индекса всегда должно быть равно 0 или 1.Because this overload has two objects in its parameter list, the value of index must always be 0 or 1. Если в позиции индекса нет параметра, FormatException создается исключение.If there is no parameter in the index position, a FormatException is thrown.
,length,length Минимальное число символов в строковом представлении параметра.The minimum number of characters in the string representation of the parameter. Если положительный, параметр размещается по правому краю; Если отрицательное, то оно по левому краю.If positive, the parameter is right-aligned; if negative, it is left-aligned.
:FormatString:formatString Строка стандартного или пользовательского формата, поддерживаемая объектом, который необходимо отформатировать.A standard or custom format string that is supported by the object to be formatted. Возможные значения для FormatString совпадают со значениями, поддерживаемыми ToString(string format) методом объекта.Possible values for formatString are the same as the values supported by the object's ToString(string format) method. Если format параметр FormatString не указан и объект, который необходимо отформатировать IFormattable , реализует null интерфейс, передается в качестве значения параметра, который используется в IFormattable.ToString качестве строки формата.If formatString is not specified and the object to be formatted implements the IFormattable interface, null is passed as the value of the format parameter that is used as the IFormattable.ToString format string.

Требуются ведущие и замыкающие символы фигурных скобок "{" и "}".The leading and trailing brace characters, "{" and "}", are required. Чтобы указать одиночную литеральную фигурную скобку в format, укажите две закрывающие или конечные фигурные скобки, то есть "{{" или "}}".To specify a single literal brace character in format, specify two leading or trailing brace characters; that is, "{{" or "}}".

Этот метод не выполняет поиск отдельных символов перехода на новую строку (шестнадцатеричное представление 0x000a) в указанной строке и не заменяет их значением свойства TextWriter.NewLine.This method does not search the specified string for individual newline characters (hexadecimal 0x000a) and replace them with TextWriter.NewLine.

Если указанный объект не указан в строке формата, он игнорируется.If a specified object is not referenced in the format string, it is ignored.

Список общих задач ввода-вывода см. в разделе Общие задачи ввода-вывода.For a list of common I/O tasks, see Common I/O Tasks.

Дополнительно

Write(Char[], Int32, Int32) Write(Char[], Int32, Int32) Write(Char[], Int32, Int32) Write(Char[], Int32, Int32)

Записывает подмассив символов в текстовый поток.Writes a subarray of characters to the text stream.

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[]

Массив символов, из которого записываются данные.The character array to write data from.

index
Int32 Int32 Int32 Int32

Положение символа в буфере, с которого начинается извлечение данных.The character position in the buffer at which to start retrieving data.

count
Int32 Int32 Int32 Int32

Количество символов для записи.The number of characters to write.

Исключения

Длина буфера минус index меньше count.The buffer length minus index is less than count.

Параметр buffer имеет значение null.The buffer parameter is null.

index или count является отрицательным значением.index or count is negative.

Ошибка ввода-вывода.An I/O error occurs.

Комментарии

Этот метод будет записывать count символы данных в это TextWriter из массива символов buffer , начиная с позиции index.This method will write count characters of data into this TextWriter from the buffer character array starting at position index.

Эта перегрузка Write(Char[]) эквивалентна перегрузке для каждого символа в buffer между index и (index + count).This overload is equivalent to the Write(Char[]) overload for each character in buffer between index and (index + count).

Список общих задач ввода-вывода см. в разделе Общие задачи ввода-вывода.For a list of common I/O tasks, see Common I/O Tasks.

Дополнительно

Write(String, Object[]) Write(String, Object[]) Write(String, Object[]) Write(String, Object[])

Записывает форматированную строку в текстовый поток, используя ту же семантику, что и метод Format(String, Object[]).Writes a formatted string to the text stream, using the same semantics as the Format(String, Object[]) method.

public:
 virtual void Write(System::String ^ format, ... cli::array <System::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 String String String

Строка составного формата.A composite format string.

arg
Object[]

Массив объектов, содержащий от нуля и более объектов, которые необходимо форматировать и записать.An object array that contains zero or more objects to format and write.

Исключения

Значение параметра format или argnull.format or arg is null.

Ошибка ввода-вывода.An I/O error occurs.

Параметр format не является допустимой строкой составного формата.format is not a valid composite format string.

- или --or- Индекс элемента формата меньше нуля или больше либо равен длине массива arg.The index of a format item is less than 0 (zero), or greater than or equal to the length of the arg array.

Комментарии

Этот метод использует составное форматирование для преобразования значения объекта в строковое представление и для внедрения этого представления в строку.This method uses composite formatting to convert the value of an object to its string representation and to embed that representation in a string. .NET обеспечивает обширную поддержку форматирования, которая подробно описывается в следующих разделах форматирования:.NET provides extensive formatting support, which is described in greater detail in the following formatting topics:

format Параметр содержит ноль или более фрагментов текста, которые пересмешиваются с нулевым или более индексированными заполнителями, называемыми элементами форматирования, которые соответствуют объекту в списке параметров этого метода.The format parameter consists of zero or more runs of text intermixed with zero or more indexed placeholders, called format items, that correspond to an object in the parameter list of this method. Процесс форматирования заменяет каждый элемент форматирования строковым представлением значения соответствующего объекта.The formatting process replaces each format item with the string representation of the value of the corresponding object.

Синтаксис элемента форматирования выглядит следующим образом:The syntax of a format item is as follows:

{index[,length] [:FormatString]}{index[,length][:formatString]}

Элементы в квадратных скобках являются необязательными.Elements in square brackets are optional. Каждый из элементов описан в таблице ниже.The following table describes each element. Дополнительные сведения о функции составного форматирования, включая синтаксис элемента форматирования, см. в разделе составное форматирование.For more information about the composite formatting feature, including the syntax of a format item, see Composite Formatting.

ЭлементElement ОписаниеDescription
индексindex Отсчитываемая от нуля координата в списке параметров объекта для форматирования.The zero-based position in the parameter list of the object to be formatted. Если объект, указанный в ** параметре nullindex, имеет значение, то элемент String.Emptyформатирования заменяется на.If the object specified by index is null, the format item is replaced by String.Empty. Поскольку эта перегрузка содержит массив в списке параметров, значение индекса всегда должно быть меньше, чем длина массива.Because this overload has an array in its parameter list, the value of index must always be less than the length of the array. Если в позиции индекса нет параметра, FormatException создается исключение.If there is no parameter in the index position, a FormatException is thrown.
,length,length Минимальное число символов в строковом представлении параметра.The minimum number of characters in the string representation of the parameter. Если положительный, параметр размещается по правому краю; Если отрицательное, то оно по левому краю.If positive, the parameter is right-aligned; if negative, it is left-aligned.
:FormatString:formatString Строка стандартного или пользовательского формата, поддерживаемая объектом, который необходимо отформатировать.A standard or custom format string that is supported by the object to be formatted. Возможные значения для FormatString совпадают со значениями, поддерживаемыми ToString(string format) методом объекта.Possible values for formatString are the same as the values supported by the object's ToString(string format) method. Если format параметр FormatString не указан и объект, который необходимо отформатировать IFormattable , реализует null интерфейс, передается в качестве значения параметра, который используется в IFormattable.ToString качестве строки формата.If formatString is not specified and the object to be formatted implements the IFormattable interface, null is passed as the value of the format parameter that is used as the IFormattable.ToString format string.

Требуются ведущие и замыкающие символы фигурных скобок "{" и "}".The leading and trailing brace characters, "{" and "}", are required. Чтобы указать одиночную литеральную фигурную скобку в format, укажите две закрывающие или конечные фигурные скобки, то есть "{{" или "}}".To specify a single literal brace character in format, specify two leading or trailing brace characters; that is, "{{" or "}}".

Этот метод не выполняет поиск отдельных символов перехода на новую строку (шестнадцатеричное представление 0x000a) в указанной строке и не заменяет их значением свойства TextWriter.NewLine.This method does not search the specified string for individual newline characters (hexadecimal 0x000a) and replace them with TextWriter.NewLine.

Если указанный объект не указан в строке формата, он игнорируется.If a specified object is not referenced in the format string, it is ignored.

Список общих задач ввода-вывода см. в разделе Общие задачи ввода-вывода.For a list of common I/O tasks, see Common I/O Tasks.

Дополнительно

Write(String, Object) Write(String, Object) Write(String, Object) Write(String, Object)

Записывает форматированную строку в текстовый поток, используя ту же семантику, что и метод Format(String, Object).Writes a formatted string to the text stream, using the same semantics as the Format(String, Object) method.

public:
 virtual void Write(System::String ^ format, System::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 String String String

Строка составного формата.A composite format string.

arg0
Object Object Object Object

Объект для форматирования и записи.The object to format and write.

Исключения

Ошибка ввода-вывода.An I/O error occurs.

Параметр format не является допустимой строкой составного формата.format is not a valid composite format string.

- или --or- Индекс элемента формата меньше 0 (нуля) или больше или равен числу объектов, которые необходимо отформатировать (которое для этой перегрузки метода равно 1).The index of a format item is less than 0 (zero), or greater than or equal to the number of objects to be formatted (which, for this method overload, is one).

Комментарии

Этот метод использует составное форматирование для преобразования значения объекта в строковое представление и для внедрения этого представления в строку.This method uses composite formatting to convert the value of an object to its string representation and to embed that representation in a string. .NET обеспечивает обширную поддержку форматирования, которая подробно описывается в следующих разделах форматирования:.NET provides extensive formatting support, which is described in greater detail in the following formatting topics:

format Параметр содержит ноль или более фрагментов текста, которые пересмешиваются с нулевым или более индексированными заполнителями, называемыми элементами форматирования, которые соответствуют объекту в списке параметров этого метода.The format parameter consists of zero or more runs of text intermixed with zero or more indexed placeholders, called format items, that correspond to an object in the parameter list of this method. Процесс форматирования заменяет каждый элемент форматирования строковым представлением значения соответствующего объекта.The formatting process replaces each format item with the string representation of the value of the corresponding object.

Синтаксис элемента форматирования выглядит следующим образом:The syntax of a format item is as follows:

{index[,length] [:FormatString]}{index[,length][:formatString]}

Элементы в квадратных скобках являются необязательными.Elements in square brackets are optional. Каждый из элементов описан в таблице ниже.The following table describes each element. Дополнительные сведения о функции составного форматирования, включая синтаксис элемента форматирования, см. в разделе составное форматирование.For more information about the composite formatting feature, including the syntax of a format item, see Composite Formatting.

ЭлементElement ОписаниеDescription
индексindex Отсчитываемая от нуля координата в списке параметров объекта для форматирования.The zero-based position in the parameter list of the object to be formatted. Если объект, указанный в ** параметре nullindex, имеет значение, то элемент String.Emptyформатирования заменяется на.If the object specified by index is null, the format item is replaced by String.Empty. Поскольку эта перегрузка содержит только один объект в списке параметров, значение индекса всегда должно быть равно 0.Because this overload has only a single object in its parameter list, the value of index must always be 0. Если в позиции индекса нет параметра, FormatException создается исключение.If there is no parameter in the index position, a FormatException is thrown.
,length,length Минимальное число символов в строковом представлении параметра.The minimum number of characters in the string representation of the parameter. Если положительный, параметр размещается по правому краю; Если отрицательное, то оно по левому краю.If positive, the parameter is right-aligned; if negative, it is left-aligned.
:FormatString:formatString Строка стандартного или пользовательского формата, поддерживаемая объектом, который необходимо отформатировать.A standard or custom format string that is supported by the object to be formatted. Возможные значения для FormatString совпадают со значениями, поддерживаемыми ToString(string format) методом объекта.Possible values for formatString are the same as the values supported by the object's ToString(string format) method. Если format параметр FormatString не указан и объект, который необходимо отформатировать IFormattable , реализует null интерфейс, передается в качестве значения параметра, который используется в IFormattable.ToString качестве строки формата.If formatString is not specified and the object to be formatted implements the IFormattable interface, null is passed as the value of the format parameter that is used as the IFormattable.ToString format string.

Требуются ведущие и замыкающие символы фигурных скобок "{" и "}".The leading and trailing brace characters, "{" and "}", are required. Чтобы указать одиночную литеральную фигурную скобку в format, укажите две закрывающие или конечные фигурные скобки, то есть "{{" или "}}".To specify a single literal brace character in format, specify two leading or trailing brace characters; that is, "{{" or "}}".

.. Этот метод не выполняет поиск отдельных символов перехода на новую строку (шестнадцатеричное представление 0x000a) в указанной строке и не заменяет их значением свойства TextWriter.NewLine.This method does not search the specified string for individual newline characters (hexadecimal 0x000a) and replace them with TextWriter.NewLine.

Если указанный объект не указан в строке формата, он игнорируется.If a specified object is not referenced in the format string, it is ignored.

Список общих задач ввода-вывода см. в разделе Общие задачи ввода-вывода.For a list of common I/O tasks, see Common I/O Tasks.

Дополнительно

Write(UInt64) Write(UInt64) Write(UInt64) Write(UInt64)

Важно!

Этот API несовместим с CLS.

Записывает в текстовый поток текстовое представление целого числа без знака размером 8 байт.Writes the text representation of an 8-byte unsigned integer to the text stream.

public:
 virtual void Write(System::UInt64 value);
[System.CLSCompliant(false)]
public virtual void Write (ulong value);
abstract member Write : uint64 -> unit
override this.Write : uint64 -> unit
Public Overridable Sub Write (value As ULong)

Параметры

value
UInt64 UInt64 UInt64 UInt64

Записываемое целое число без знака размером 8 байт.The 8-byte unsigned integer to write.

Исключения

Ошибка ввода-вывода.An I/O error occurs.

Комментарии

Текстовое представление указанного значения создается путем вызова UInt64.ToString метода.The text representation of the specified value is produced by calling the UInt64.ToString method. Свойство, если нет null, указывает форматирование, зависящее от языка и региональных параметров. TextWriter.FormatProviderThe TextWriter.FormatProvider property, if not null, specifies the culture-specific formatting.

Список общих задач ввода-вывода см. в разделе Общие задачи ввода-вывода.For a list of common I/O tasks, see Common I/O Tasks.

Дополнительно

Write(UInt32) Write(UInt32) Write(UInt32) Write(UInt32)

Важно!

Этот API несовместим с CLS.

Записывает в текстовый поток текстовое представление целого числа без знака размером 4 байта.Writes the text representation of a 4-byte unsigned integer to the text stream.

public:
 virtual void Write(System::UInt32 value);
[System.CLSCompliant(false)]
public virtual void Write (uint value);
abstract member Write : uint32 -> unit
override this.Write : uint32 -> unit
Public Overridable Sub Write (value As UInteger)

Параметры

value
UInt32 UInt32 UInt32 UInt32

Записываемое целое число без знака размером 4 байта.The 4-byte unsigned integer to write.

Исключения

Ошибка ввода-вывода.An I/O error occurs.

Комментарии

Текстовое представление указанного значения создается путем вызова UInt32.ToString метода.The text representation of the specified value is produced by calling the UInt32.ToString method. Свойство, если нет null, указывает форматирование, зависящее от языка и региональных параметров. TextWriter.FormatProviderThe TextWriter.FormatProvider property, if not null, specifies the culture-specific formatting.

Список общих задач ввода-вывода см. в разделе Общие задачи ввода-вывода.For a list of common I/O tasks, see Common I/O Tasks.

Дополнительно

Write(StringBuilder) Write(StringBuilder) Write(StringBuilder) Write(StringBuilder)

Записывает построитель строки в текстовый поток.Writes a string builder to the text stream.

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 StringBuilder StringBuilder StringBuilder

Строка как построитель строки для записи в текстовый поток.The string, as a string builder, to write to the text stream.

Комментарии

Этот метод эквивалентен Write(stringBuilder.ToString()), но он StringBuilder.GetChunks использует метод, чтобы избежать создания промежуточной строки.This method is equivalent to Write(stringBuilder.ToString()), but it uses the StringBuilder.GetChunks method to avoid creating the intermediate string.

Write(String) Write(String) Write(String) Write(String)

Асинхронно записывает строку в текстовый поток.Writes a string to the text stream.

public:
 virtual void Write(System::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 String String String

Строка для записи.The string to write.

Исключения

Ошибка ввода-вывода.An I/O error occurs.

Комментарии

Эта перегрузка эквивалентна Write(Char[]) перегрузке.This overload is equivalent to the Write(Char[]) overload.

Этот метод не выполняет поиск отдельных символов перехода на новую строку (шестнадцатеричное представление 0x000a) в указанной строке и не заменяет их значением свойства TextWriter.NewLine.This method does not search the specified string for individual newline characters (hexadecimal 0x000a) and replace them with TextWriter.NewLine.

Если параметр value имеет значение null, в текстовый поток ничего не записывается.If value is null, nothing is written to the text stream.

Список общих задач ввода-вывода см. в разделе Общие задачи ввода-вывода.For a list of common I/O tasks, see Common I/O Tasks.

Дополнительно

Write(Single) Write(Single) Write(Single) Write(Single)

Записывает в текстовый поток текстовое представление значения с плавающей запятой размером 4 байта.Writes the text representation of a 4-byte floating-point value to the text stream.

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 Single Single Single

Записываемое значение с плавающей запятой размером 4 байта.The 4-byte floating-point value to write.

Исключения

Ошибка ввода-вывода.An I/O error occurs.

Комментарии

Текстовое представление указанного значения создается путем вызова Single.ToString метода.The text representation of the specified value is produced by calling the Single.ToString method. Свойство, если нет null, указывает форматирование, зависящее от языка и региональных параметров. TextWriter.FormatProviderThe TextWriter.FormatProvider property, if not null, specifies the culture-specific formatting.

Список общих задач ввода-вывода см. в разделе Общие задачи ввода-вывода.For a list of common I/O tasks, see Common I/O Tasks.

Дополнительно

Write(String, Object, Object, Object) Write(String, Object, Object, Object) Write(String, Object, Object, Object) Write(String, Object, Object, Object)

Записывает форматированную строку в текстовый поток, используя ту же семантику, что и метод Format(String, Object, Object, Object).Writes a formatted string to the text stream, using the same semantics as the Format(String, Object, Object, Object) method.

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);
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 String String String

Строка составного формата.A composite format string.

arg0
Object Object Object Object

Первый объект для форматирования и записи.The first object to format and write.

arg1
Object Object Object Object

Второй объект для форматирования и записи.The second object to format and write.

arg2
Object Object Object Object

Третий объект для форматирования и записи.The third object to format and write.

Исключения

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

Ошибка ввода-вывода.An I/O error occurs.

Параметр format не является допустимой строкой составного формата.format is not a valid composite format string.

-или--or- Индекс элемента формата меньше 0 (нуля) или больше или равен числу объектов, которые необходимо отформатировать (которое для этой перегрузки метода равно 3).The index of a format item is less than 0 (zero), or greater than or equal to the number of objects to be formatted (which, for this method overload, is three).

Комментарии

Этот метод использует составное форматирование для преобразования значения объекта в строковое представление и для внедрения этого представления в строку.This method uses composite formatting to convert the value of an object to its string representation and to embed that representation in a string. .NET обеспечивает обширную поддержку форматирования, которая подробно описывается в следующих разделах форматирования:.NET provides extensive formatting support, which is described in greater detail in the following formatting topics:

format Параметр содержит ноль или более фрагментов текста, которые пересмешиваются с нулевым или более индексированными заполнителями, называемыми элементами форматирования, которые соответствуют объекту в списке параметров этого метода.The format parameter consists of zero or more runs of text intermixed with zero or more indexed placeholders, called format items, that correspond to an object in the parameter list of this method. Процесс форматирования заменяет каждый элемент форматирования строковым представлением значения соответствующего объекта.The formatting process replaces each format item with the string representation of the value of the corresponding object.

Синтаксис элемента форматирования выглядит следующим образом:The syntax of a format item is as follows:

{index[,length] [:FormatString]}{index[,length][:formatString]}

Элементы в квадратных скобках являются необязательными.Elements in square brackets are optional. Каждый из элементов описан в таблице ниже.The following table describes each element. Дополнительные сведения о функции составного форматирования, включая синтаксис элемента форматирования, см. в разделе составное форматирование.For more information about the composite formatting feature, including the syntax of a format item, see Composite Formatting.

ЭлементElement ОписаниеDescription
индексindex Отсчитываемая от нуля координата в списке параметров объекта для форматирования.The zero-based position in the parameter list of the object to be formatted. Если объект, указанный в ** параметре nullindex, имеет значение, то элемент String.Emptyформатирования заменяется на.If the object specified by index is null, the format item is replaced by String.Empty. Поскольку эта перегрузка содержит три объекта в списке параметров, значение индекса всегда должно быть равно 0, 1 или 2.Because this overload has three objects in its parameter list, the value of index must always be 0, 1, or 2. Если в позиции индекса нет параметра, FormatException создается исключение.If there is no parameter in the index position, a FormatException is thrown.
,length,length Минимальное число символов в строковом представлении параметра.The minimum number of characters in the string representation of the parameter. Если положительный, параметр размещается по правому краю; Если отрицательное, то оно по левому краю.If positive, the parameter is right-aligned; if negative, it is left-aligned.
:FormatString:formatString Строка стандартного или пользовательского формата, поддерживаемая объектом, который необходимо отформатировать.A standard or custom format string that is supported by the object to be formatted. Возможные значения для FormatString совпадают со значениями, поддерживаемыми ToString(string format) методом объекта.Possible values for formatString are the same as the values supported by the object's ToString(string format) method. Если format параметр FormatString не указан и объект, который необходимо отформатировать IFormattable , реализует null интерфейс, передается в качестве значения параметра, который используется в IFormattable.ToString качестве строки формата.If formatString is not specified and the object to be formatted implements the IFormattable interface, null is passed as the value of the format parameter that is used as the IFormattable.ToString format string.

Требуются ведущие и замыкающие символы фигурных скобок "{" и "}".The leading and trailing brace characters, "{" and "}", are required. Чтобы указать одиночную литеральную фигурную скобку в format, укажите две закрывающие или конечные фигурные скобки, то есть "{{" или "}}".To specify a single literal brace character in format, specify two leading or trailing brace characters; that is, "{{" or "}}".

Этот метод не выполняет поиск в указанной строке отдельных символов новой строки (шестнадцатеричной 0x000a) и заменяет их TextWriter.NewLineна.This method does not search the specified string for individual newline characters (hexadecimal 0x000a) and replace them with TextWriter.NewLine.

Если указанный объект не указан в строке формата, он игнорируется.If a specified object is not referenced in the format string, it is ignored.

Список общих задач ввода-вывода см. в разделе Общие задачи ввода-вывода.For a list of common I/O tasks, see Common I/O Tasks.

Дополнительно

Write(Object) Write(Object) Write(Object) Write(Object)

Записывает в текстовый поток текстовое представление объекта с помощью вызова метода ToString для этого объекта.Writes the text representation of an object to the text stream by calling the ToString method on that object.

public:
 virtual void Write(System::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 Object Object Object

Записываемый объект.The object to write.

Исключения

Ошибка ввода-вывода.An I/O error occurs.

Комментарии

Эта перегрузка эквивалентна Write(String) перегрузке.This overload is equivalent to the Write(String) overload.

Если указанный объект имеет значение null, никакие действия не предпринимаются и исключение не создается.If the specified object is null, no action is taken and no exception is thrown. В противном случае вызывается ToString метод объекта для создания строкового представления, а результирующая строка записывается в поток вывода.Otherwise, the object's ToString method is called to produce the string representation, and the resulting string is then written to the output stream. Свойство, если нет null, указывает форматирование, зависящее от языка и региональных параметров. FormatProviderThe FormatProvider property, if not null, specifies the culture-specific formatting.

Список общих задач ввода-вывода см. в разделе Общие задачи ввода-вывода.For a list of common I/O tasks, see Common I/O Tasks.

Дополнительно

Write(Int64) Write(Int64) Write(Int64) Write(Int64)

Записывает в текстовый поток текстовое представление целого числа со знаком размером 8 байт.Writes the text representation of an 8-byte signed integer to the text stream.

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 Int64 Int64 Int64

Записываемое целое число со знаком размером 8 байт.The 8-byte signed integer to write.

Исключения

Ошибка ввода-вывода.An I/O error occurs.

Комментарии

Текстовое представление указанного значения создается путем вызова Int64.ToString метода.The text representation of the specified value is produced by calling the Int64.ToString method. Свойство, если нет null, указывает форматирование, зависящее от языка и региональных параметров. TextWriter.FormatProviderThe TextWriter.FormatProvider property, if not null, specifies the culture-specific formatting.

Список общих задач ввода-вывода см. в разделе Общие задачи ввода-вывода.For a list of common I/O tasks, see Common I/O Tasks.

Практическое руководство. Запись текста в файлHow to: Write Text to a File

Дополнительно

Write(Int32) Write(Int32) Write(Int32) Write(Int32)

Записывает в текстовый поток текстовое представление целого числа со знаком размером 4 байта.Writes the text representation of a 4-byte signed integer to the text stream.

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 Int32 Int32 Int32

Записываемое целое число со знаком размером 4 байта.The 4-byte signed integer to write.

Исключения

Ошибка ввода-вывода.An I/O error occurs.

Комментарии

Текстовое представление указанного значения создается путем вызова Int32.ToString метода.The text representation of the specified value is produced by calling the Int32.ToString method. Свойство, если нет null, указывает форматирование, зависящее от языка и региональных параметров. TextWriter.FormatProviderThe TextWriter.FormatProvider property, if not null, specifies the culture-specific formatting.

Список общих задач ввода-вывода см. в разделе Общие задачи ввода-вывода.For a list of common I/O tasks, see Common I/O Tasks.

Дополнительно

Write(Double) Write(Double) Write(Double) Write(Double)

Записывает в текстовый поток текстовое представление значения с плавающей запятой размером 8 байт.Writes the text representation of an 8-byte floating-point value to the text stream.

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 Double Double Double

Записываемое значение с плавающей запятой размером 8 байт.The 8-byte floating-point value to write.

Исключения

Ошибка ввода-вывода.An I/O error occurs.

Комментарии

Текстовое представление указанного значения создается путем вызова Double.ToString метода.The text representation of the specified value is produced by calling the Double.ToString method. Свойство, если нет null, указывает форматирование, зависящее от языка и региональных параметров. TextWriter.FormatProviderThe TextWriter.FormatProvider property, if not null, specifies the culture-specific formatting.

Список общих задач ввода-вывода см. в разделе Общие задачи ввода-вывода.For a list of common I/O tasks, see Common I/O Tasks.

Дополнительно

Write(Decimal) Write(Decimal) Write(Decimal) Write(Decimal)

Записывает текстовое представление десятичного значения в текстовый поток.Writes the text representation of a decimal value to the text stream.

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 Decimal Decimal Decimal

Десятичное значение, которое необходимо записать.The decimal value to write.

Исключения

Ошибка ввода-вывода.An I/O error occurs.

Комментарии

Свойство, если нет null, указывает форматирование, зависящее от языка и региональных параметров. FormatProviderThe FormatProvider property, if not null, specifies the culture-specific formatting.

Дополнительно

Write(Char[]) Write(Char[]) Write(Char[]) Write(Char[])

Записывает массив символов в текстовый поток.Writes a character array to the text stream.

public:
 virtual void Write(cli::array <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[]

Массив символов, записываемый в текстовый поток.The character array to write to the text stream.

Исключения

Ошибка ввода-вывода.An I/O error occurs.

Комментарии

Этот метод не выполняет поиск отдельных символов перехода на новую строку (шестнадцатеричное представление 0x000a) в указанной строке и не заменяет их значением свойства NewLine.This method does not search the specified string for individual newline characters (hexadecimal 0x000a) and replace them with NewLine.

Этот метод по умолчанию Write(Char[], Int32, Int32) вызывает метод и передает весь массив символов.This default method calls the Write(Char[], Int32, Int32) method and passes the entire character array. Если массив символов имеет значение null, ничего не записывается.If the character array is null, nothing is written.

Список общих задач ввода-вывода см. в разделе Общие задачи ввода-вывода.For a list of common I/O tasks, see Common I/O Tasks.

Дополнительно

Write(Char) Write(Char) Write(Char) Write(Char)

Записывает символ в текстовый поток.Writes a character to the text stream.

public:
 virtual void Write(char value);
public virtual void Write (char value);
abstract member Write : char -> unit
override this.Write : char -> unit
Public Overridable Sub Write (value As Char)

Параметры

value
Char Char Char Char

Символ, записываемый в текстовый поток.The character to write to the text stream.

Исключения

Ошибка ввода-вывода.An I/O error occurs.

Комментарии

Этот метод по умолчанию не выполняет никаких действий, но производные классы могут переопределять метод, чтобы обеспечить соответствующую функциональность.This default method does nothing, but derived classes can override the method to provide the appropriate functionality.

Список общих задач ввода-вывода см. в разделе Общие задачи ввода-вывода.For a list of common I/O tasks, see Common I/O Tasks.

Дополнительно

Write(Boolean) Write(Boolean) Write(Boolean) Write(Boolean)

Записывает текстовое представление значения типа Boolean в текстовый поток.Writes the text representation of a Boolean value to the text stream.

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 Boolean Boolean

Значение Boolean для записи.The Boolean value to write.

Исключения

Ошибка ввода-вывода.An I/O error occurs.

Комментарии

Текстовое представление указанного значения создается путем вызова Boolean.ToString метода.The text representation of the specified value is produced by calling the Boolean.ToString method.

Этот метод выводит Boolean.TrueString либо Boolean.FalseString.This method outputs either Boolean.TrueString or Boolean.FalseString.

Список общих задач ввода-вывода см. в разделе Общие задачи ввода-вывода.For a list of common I/O tasks, see Common I/O Tasks.

Дополнительно

Write(ReadOnlySpan<Char>) Write(ReadOnlySpan<Char>) Write(ReadOnlySpan<Char>) Write(ReadOnlySpan<Char>)

Записывает диапазон символов в текстовый поток.Writes a character span to the text stream.

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>

Записываемый диапазон символов.The character span to write.

Комментарии

Текстовое представление указанного значения создается путем вызова метода реадонлиспан. Метод ToString .The text representation of the specified value is produced by calling the ReadOnlySpan.ToString method.

Список общих задач ввода-вывода см. в разделе Общие задачи ввода-вывода.For a list of common I/O tasks, see Common I/O Tasks.

Применяется к