TextWriter.WriteLine Метод

Определение

Записывает в текстовый поток данные, за которыми следует признак конца строки.Writes data to the text stream, followed by a line terminator.

Перегрузки

WriteLine(String, Object, Object)

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

WriteLine(Char[], Int32, Int32)

Записывает в текстовый поток подмассив символов, за которым следует признак конца строки.Writes a subarray of characters to the text stream, followed by a line terminator.

WriteLine(String, Object[])

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

WriteLine(String, Object)

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

WriteLine(UInt64)

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

WriteLine(UInt32)

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

WriteLine(String, Object, Object, Object)

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

WriteLine(StringBuilder)

Записывает в текстовый поток текстовое представление построителя строки, за которым следует знак конца строки.Writes the text representation of a string builder to the text stream, followed by a line terminator.

WriteLine(String)

Записывает в текстовый поток строку, за которой следует признак конца строки.Writes a string to the text stream, followed by a line terminator.

WriteLine(Single)

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

WriteLine(Double)

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

WriteLine(Object)

Записывает в текстовый поток текстовое представление объекта путем вызова метода ToString для этого объекта, за которым следует признак конца строки.Writes the text representation of an object to the text stream, by calling the ToString method on that object, followed by a line terminator.

WriteLine(Int64)

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

WriteLine(Int32)

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

WriteLine(Decimal)

Записывает в текстовый поток текстовое представление десятичного значения, за которым следует знак конца строки.Writes the text representation of a decimal value to the text stream, followed by a line terminator.

WriteLine(Char[])

Записывает в текстовый поток массив символов, за которыми следует признак конца строки.Writes an array of characters to the text stream, followed by a line terminator.

WriteLine(Char)

Записывает в текстовый поток символ, за которым следует признак конца строки.Writes a character to the text stream, followed by a line terminator.

WriteLine(Boolean)

Записывает в текстовый поток текстовое представление значения типа Boolean, за которым следует знак конца строки.Writes the text representation of a Boolean value to the text stream, followed by a line terminator.

WriteLine()

Записывает признак конца строки в текстовый поток.Writes a line terminator to the text stream.

WriteLine(ReadOnlySpan<Char>)

Записывает в текстовый поток текстовое представление диапазона символов, за которым следует знак конца строки.Writes the text representation of a character span to the text stream, followed by a line terminator.

WriteLine(String, Object, Object)

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

public:
 virtual void WriteLine(System::String ^ format, System::Object ^ arg0, System::Object ^ arg1);
public virtual void WriteLine (string format, object arg0, object arg1);
abstract member WriteLine : string * obj * obj -> unit
override this.WriteLine : string * obj * obj -> unit
Public Overridable Sub WriteLine (format As String, arg0 As Object, arg1 As Object)

Параметры

format
String

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

arg0
Object

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

arg1
Object

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

Исключения

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

Объект TextWriter закрыт.The TextWriter is closed.

Ошибка ввода-вывода.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) в указанной строке и не заменяет их значением свойства NewLine.This method does not search the specified string for individual newline characters (hexadecimal 0x000a) and replace them with NewLine.

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

Признак конца строки определяется CoreNewLine полем.The line terminator is defined by the CoreNewLine field.

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

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

WriteLine(Char[], Int32, Int32)

Записывает в текстовый поток подмассив символов, за которым следует признак конца строки.Writes a subarray of characters to the text stream, followed by a line terminator.

public:
 virtual void WriteLine(cli::array <char> ^ buffer, int index, int count);
public virtual void WriteLine (char[] buffer, int index, int count);
abstract member WriteLine : char[] * int * int -> unit
override this.WriteLine : char[] * int * int -> unit
Public Overridable Sub WriteLine (buffer As Char(), index As Integer, count As Integer)

Параметры

buffer
Char[]

Массив символов, из которого считываются данные.The character array from which data is read.

index
Int32

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

count
Int32

Наибольшее количество символов для записи.The maximum 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.

Объект TextWriter закрыт.The TextWriter is closed.

Ошибка ввода-вывода.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[]) эквивалентна вызову метода, WriteLine за которым следует каждый символ в buffer между index и (index + count).This overload is equivalent to calling the Write(Char[]) method followed by WriteLine for each character in buffer between index and (index + count).

Признак конца строки определяется CoreNewLine полем.The line terminator is defined by the CoreNewLine field.

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

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

WriteLine(String, Object[])

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

public:
 virtual void WriteLine(System::String ^ format, ... cli::array <System::Object ^> ^ arg);
public virtual void WriteLine (string format, params object[] arg);
abstract member WriteLine : string * obj[] -> unit
override this.WriteLine : string * obj[] -> unit
Public Overridable Sub WriteLine (format As String, ParamArray arg As Object())

Параметры

format
String

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

arg
Object[]

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

Исключения

Строка или объект передаются в виде null.A string or object is passed in as null.

Объект TextWriter закрыт.The TextWriter is closed.

Ошибка ввода-вывода.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) в указанной строке и не заменяет их значением свойства NewLine.This method does not search the specified string for individual newline characters (hexadecimal 0x000a) and replace them with NewLine.

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

Признак конца строки определяется CoreNewLine полем.The line terminator is defined by the CoreNewLine field.

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

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

WriteLine(String, Object)

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

public:
 virtual void WriteLine(System::String ^ format, System::Object ^ arg0);
public virtual void WriteLine (string format, object arg0);
abstract member WriteLine : string * obj -> unit
override this.WriteLine : string * obj -> unit
Public Overridable Sub WriteLine (format As String, arg0 As Object)

Параметры

format
String

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

arg0
Object

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

Исключения

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

Объект TextWriter закрыт.The TextWriter is closed.

Ошибка ввода-вывода.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) в указанной строке и не заменяет их значением свойства NewLine.This method does not search the specified string for individual newline characters (hexadecimal 0x000a) and replace them with NewLine.

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

Признак конца строки определяется CoreNewLine полем.The line terminator is defined by the CoreNewLine field.

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

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

WriteLine(UInt64)

Важно!

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

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

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

Параметры

value
UInt64

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

Атрибуты

Исключения

Объект TextWriter закрыт.The TextWriter is closed.

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

Комментарии

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

Признак конца строки определяется CoreNewLine полем.The line terminator is defined by the CoreNewLine field.

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

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

WriteLine(UInt32)

Важно!

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

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

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

Параметры

value
UInt32

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

Атрибуты

Исключения

Объект TextWriter закрыт.The TextWriter is closed.

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

Комментарии

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

Признак конца строки определяется CoreNewLine полем.The line terminator is defined by the CoreNewLine field.

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

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

WriteLine(String, Object, Object, Object)

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

public:
 virtual void WriteLine(System::String ^ format, System::Object ^ arg0, System::Object ^ arg1, System::Object ^ arg2);
public virtual void WriteLine (string format, object arg0, object arg1, object arg2);
abstract member WriteLine : string * obj * obj * obj -> unit
override this.WriteLine : string * obj * obj * obj -> unit
Public Overridable Sub WriteLine (format As String, arg0 As Object, arg1 As Object, arg2 As Object)

Параметры

format
String

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

arg0
Object

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

arg1
Object

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

arg2
Object

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

Исключения

formatnull.format is null.

Объект TextWriter закрыт.The TextWriter is closed.

Ошибка ввода-вывода.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) в указанной строке и не заменяет их значением свойства NewLine.This method does not search the specified string for individual newline characters (hexadecimal 0x000a) and replace them with NewLine.

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

Признак конца строки определяется CoreNewLine полем.The line terminator is defined by the CoreNewLine field.

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

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

WriteLine(StringBuilder)

Записывает в текстовый поток текстовое представление построителя строки, за которым следует знак конца строки.Writes the text representation of a string builder to the text stream, followed by a line terminator.

public:
 virtual void WriteLine(System::Text::StringBuilder ^ value);
public virtual void WriteLine (System.Text.StringBuilder value);
abstract member WriteLine : System.Text.StringBuilder -> unit
override this.WriteLine : System.Text.StringBuilder -> unit
Public Overridable Sub WriteLine (value As StringBuilder)

Параметры

value
StringBuilder

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

Комментарии

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

Признак конца строки определяется CoreNewLine полем.The line terminator is defined by the CoreNewLine field.

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

WriteLine(String)

Записывает в текстовый поток строку, за которой следует признак конца строки.Writes a string to the text stream, followed by a line terminator.

public:
 virtual void WriteLine(System::String ^ value);
public virtual void WriteLine (string value);
abstract member WriteLine : string -> unit
override this.WriteLine : string -> unit
Public Overridable Sub WriteLine (value As String)

Параметры

value
String

Строка для записи.The string to write. Если value имеет значение null, записывается только признак конца строки.If value is null, only the line terminator is written.

Исключения

Объект TextWriter закрыт.The TextWriter is closed.

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

Комментарии

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

Признак конца строки определяется CoreNewLine полем.The line terminator is defined by the CoreNewLine field.

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

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

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

WriteLine(Single)

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

public:
 virtual void WriteLine(float value);
public virtual void WriteLine (float value);
abstract member WriteLine : single -> unit
override this.WriteLine : single -> unit
Public Overridable Sub WriteLine (value As Single)

Параметры

value
Single

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

Исключения

Объект TextWriter закрыт.The TextWriter is closed.

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

Комментарии

Свойство, если нет 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.

Признак конца строки определяется CoreNewLine полем.The line terminator is defined by the CoreNewLine field.

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

WriteLine(Double)

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

public:
 virtual void WriteLine(double value);
public virtual void WriteLine (double value);
abstract member WriteLine : double -> unit
override this.WriteLine : double -> unit
Public Overridable Sub WriteLine (value As Double)

Параметры

value
Double

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

Исключения

Объект TextWriter закрыт.The TextWriter is closed.

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

Комментарии

Свойство, если нет 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.

Признак конца строки определяется CoreNewLine полем.The line terminator is defined by the CoreNewLine field.

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

WriteLine(Object)

Записывает в текстовый поток текстовое представление объекта путем вызова метода ToString для этого объекта, за которым следует признак конца строки.Writes the text representation of an object to the text stream, by calling the ToString method on that object, followed by a line terminator.

public:
 virtual void WriteLine(System::Object ^ value);
public virtual void WriteLine (object value);
abstract member WriteLine : obj -> unit
override this.WriteLine : obj -> unit
Public Overridable Sub WriteLine (value As Object)

Параметры

value
Object

Записываемый объект.The object to write. Если value имеет значение null, записывается только признак конца строки.If value is null, only the line terminator is written.

Исключения

Объект TextWriter закрыт.The TextWriter is closed.

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

Комментарии

Эта перегрузка эквивалентна Write(String, Object) перегрузке.This overload is equivalent to the Write(String, Object) overload. Свойство, если нет null, указывает форматирование, зависящее от языка и региональных параметров. FormatProviderThe FormatProvider property, if not null, specifies the culture-specific formatting.

Признак конца строки определяется CoreNewLine полем.The line terminator is defined by the CoreNewLine field.

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

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

WriteLine(Int64)

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

public:
 virtual void WriteLine(long value);
public virtual void WriteLine (long value);
abstract member WriteLine : int64 -> unit
override this.WriteLine : int64 -> unit
Public Overridable Sub WriteLine (value As Long)

Параметры

value
Int64

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

Исключения

Объект TextWriter закрыт.The TextWriter is closed.

Ошибка ввода-вывода.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.

Признак конца строки определяется CoreNewLine полем.The line terminator is defined by the CoreNewLine field.

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

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

WriteLine(Int32)

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

public:
 virtual void WriteLine(int value);
public virtual void WriteLine (int value);
abstract member WriteLine : int -> unit
override this.WriteLine : int -> unit
Public Overridable Sub WriteLine (value As Integer)

Параметры

value
Int32

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

Исключения

Объект TextWriter закрыт.The TextWriter is closed.

Ошибка ввода-вывода.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.

Признак конца строки определяется CoreNewLine полем.The line terminator is defined by the CoreNewLine field.

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

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

WriteLine(Decimal)

Записывает в текстовый поток текстовое представление десятичного значения, за которым следует знак конца строки.Writes the text representation of a decimal value to the text stream, followed by a line terminator.

public:
 virtual void WriteLine(System::Decimal value);
public virtual void WriteLine (decimal value);
abstract member WriteLine : decimal -> unit
override this.WriteLine : decimal -> unit
Public Overridable Sub WriteLine (value As Decimal)

Параметры

value
Decimal

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

Исключения

Объект TextWriter закрыт.The TextWriter is closed.

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

Комментарии

Свойство, если нет 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.

Признак конца строки определяется CoreNewLine полем.The line terminator is defined by the CoreNewLine field.

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

WriteLine(Char[])

Записывает в текстовый поток массив символов, за которыми следует признак конца строки.Writes an array of characters to the text stream, followed by a line terminator.

public:
 virtual void WriteLine(cli::array <char> ^ buffer);
public virtual void WriteLine (char[] buffer);
abstract member WriteLine : char[] -> unit
override this.WriteLine : char[] -> unit
Public Overridable Sub WriteLine (buffer As Char())

Параметры

buffer
Char[]

Массив символов, из которого считываются данные.The character array from which data is read.

Исключения

Объект TextWriter закрыт.The TextWriter is closed.

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

Комментарии

Все символы в buffer записываются в базовый поток.All the characters in buffer are written to the underlying stream. Если массив символов имеет значение null, записывается только признак конца строки.If the character array is null, only the line terminator is written.

Эта перегрузка эквивалентна Write(Char[]) , WriteLine() за которой следует.This overload is equivalent to Write(Char[]) followed by WriteLine() .

Признак конца строки определяется CoreNewLine полем.The line terminator is defined by the CoreNewLine field.

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

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

WriteLine(Char)

Записывает в текстовый поток символ, за которым следует признак конца строки.Writes a character to the text stream, followed by a line terminator.

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

Параметры

value
Char

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

Исключения

Объект TextWriter закрыт.The TextWriter is closed.

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

Комментарии

Эта перегрузка эквивалентна Write(Char) , WriteLine() за которой следует.This overload is equivalent to Write(Char) followed by WriteLine() .

Признак конца строки определяется CoreNewLine полем.The line terminator is defined by the CoreNewLine field.

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

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

WriteLine(Boolean)

Записывает в текстовый поток текстовое представление значения типа Boolean, за которым следует знак конца строки.Writes the text representation of a Boolean value to the text stream, followed by a line terminator.

public:
 virtual void WriteLine(bool value);
public virtual void WriteLine (bool value);
abstract member WriteLine : bool -> unit
override this.WriteLine : bool -> unit
Public Overridable Sub WriteLine (value As Boolean)

Параметры

value
Boolean

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

Исключения

Объект TextWriter закрыт.The TextWriter is closed.

Ошибка ввода-вывода.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.

Признак конца строки определяется CoreNewLine полем.The line terminator is defined by the CoreNewLine field.

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

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

WriteLine()

Записывает признак конца строки в текстовый поток.Writes a line terminator to the text stream.

public:
 virtual void WriteLine();
public virtual void WriteLine ();
abstract member WriteLine : unit -> unit
override this.WriteLine : unit -> unit
Public Overridable Sub WriteLine ()

Исключения

Объект TextWriter закрыт.The TextWriter is closed.

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

Комментарии

Признак конца строки определяется CoreNewLine полем.The line terminator is defined by the CoreNewLine field.

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

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

WriteLine(ReadOnlySpan<Char>)

Записывает в текстовый поток текстовое представление диапазона символов, за которым следует знак конца строки.Writes the text representation of a character span to the text stream, followed by a line terminator.

public:
 virtual void WriteLine(ReadOnlySpan<char> buffer);
public virtual void WriteLine (ReadOnlySpan<char> buffer);
abstract member WriteLine : ReadOnlySpan<char> -> unit
override this.WriteLine : ReadOnlySpan<char> -> unit
Public Overridable Sub WriteLine (buffer As ReadOnlySpan(Of Char))

Параметры

buffer
ReadOnlySpan<Char>

Значение диапазона символов, записываемое в текстовый поток.The char span value to write to the text stream.

Комментарии

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

Признак конца строки определяется CoreNewLine полем.The line terminator is defined by the CoreNewLine field.

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

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