TextWriter.WriteLine 方法

定义

将数据写入文本流,后跟行终止符。

重载

WriteLine(String, Object, Object)

使用与 Format(String, Object, Object) 方法相同的语义将格式化字符串和新行写入文本流。

WriteLine(Char[], Int32, Int32)

将字符子数组写入文本流,后跟行终止符。

WriteLine(String, Object[])

使用与 Format(String, Object) 相同的语义将格式化字符串和新行写入文本流。

WriteLine(String, Object)

使用与 Format(String, Object) 方法相同的语义将格式化字符串和新行写入文本流。

WriteLine(UInt64)

将 8 字节无符号整数的文本表示形式写入文本流,后跟行终止符。

WriteLine(UInt32)

将 4 字节无符号整数的文本表示形式写入文本流,后跟行终止符。

WriteLine(String, Object, Object, Object)

使用与 Format(String, Object) 相同的语义将格式化字符串和新行写入文本流。

WriteLine(StringBuilder)

将字符串生成器的文本表示形式写入文本流,后跟行终止符。

WriteLine(String)

将字符串写入文本流,后跟行终止符。

WriteLine(Single)

将 4 字节浮点值的文本表示形式写入文本流,后跟行终止符。

WriteLine(Double)

将 8 字节浮点值的文本表示形式写入文本流,后跟行终止符。

WriteLine(Object)

通过在对象上调用 ToString 方法将此对象的文本表示形式写入文本流,后跟行终止符。

WriteLine(Int64)

将 8 字节带符号整数的文本表示形式写入文本流,后跟行终止符。

WriteLine(Int32)

将 4 字节带符号整数的文本表示形式写入文本流,后跟行终止符。

WriteLine(Decimal)

将小数值的文本表示形式写入文本流,后跟行终止符。

WriteLine(Char[])

将字符数组写入文本流,后跟行终止符。

WriteLine(Char)

将字符写入文本流,后跟行终止符。

WriteLine(Boolean)

Boolean 值的文本表示形式写入文本流,后跟行终止符。

WriteLine()

将行终止符写入文本流。

WriteLine(ReadOnlySpan<Char>)

将字符范围的文本表示形式写入文本流,后跟行终止符。

WriteLine(String, Object, Object)

使用与 Format(String, Object, Object) 方法相同的语义将格式化字符串和新行写入文本流。

public:
 virtual void WriteLine(System::String ^ format, System::Object ^ arg0, System::Object ^ arg1);
public virtual void WriteLine (string format, object arg0, 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

复合格式字符串。

arg0
Object

要格式化和写入的第一个对象。

arg1
Object

要格式化和写入的第二个对象。

例外

formatnull

出现 I/O 错误。

format 不是有效的复合格式字符串。

  • 或 - 格式项的索引小于 0 (0)、或大于或等于要设置格式的对象数 (用于该方法重载,为二)。

注解

此方法使用复合格式将对象的值转换为其字符串表示形式,并在字符串中嵌入该表示形式。 .NET 提供广泛的格式支持,在以下格式设置主题中更详细地描述了这些支持:

format 参数包含与零个或多个索引占位符(称为格式项)混合的文本运行,这些占位符与此方法的参数列表中的对象相对应。 格式设置过程将每个格式项替换为相应对象的值的字符串表示形式。

格式项的语法如下所示:

{index[,length][:formatString]}

括号中的元素是可选的。 下表对每个元素进行了描述。 有关复合格式设置功能的详细信息,包括格式项的语法,请参阅 复合格式设置

元素 说明
索引 要设置格式的对象参数列表中的从零开始的位置。 如果 索引 指定的对象是 null,则格式项将被 String.Empty替换。 由于此重载在其参数列表中有两个对象, 因此索引 的值必须始终为 0 或 1。 如果 索引 位置中没有参数,则会引发一个 FormatException
length 参数的字符串表示形式的最小字符数。 如果为正,则参数右对齐;如果为负,则为左对齐。
formatString 要格式化的对象支持的标准或自定义格式字符串。 formatString 的可能值与对象ToString(string format)方法支持的值相同。 如果未指定 formatString 并且要格式化的对象实现IFormattable接口,null则作为用作IFormattable.ToString格式字符串的参数的值format传递。

前导和尾部大括号字符“{”和“}”是必需的。 若要在中 format指定单个文本大括号字符,请指定两个前导或尾随大括号;即“{{”或“}}”。

此方法不搜索指定字符串以查找 (十六进制0x000a) 的单个换行字符,并将其替换为 NewLine

如果未在格式字符串中引用指定对象,则忽略该对象。

行终止符由 CoreNewLine 字段定义。

有关常见 I/O 任务的列表,请参阅 常见 I/O 任务

另请参阅

适用于

WriteLine(Char[], Int32, Int32)

将字符子数组写入文本流,后跟行终止符。

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

从其读取数据的字符数组。

index
Int32

在开始读取数据时 buffer 中的字符位置。

count
Int32

要写入的最大字符数。

例外

缓冲区长度减去 index 小于 count

buffer 参数为 null

indexcount 为负数。

出现 I/O 错误。

注解

此方法将从位置index开始的buffer字符数组将数据写入countTextWriter字符。

此重载等效于为介于和index () count + index中的每个字符buffer调用Write(Char[])后跟WriteLine的方法。

行终止符由 CoreNewLine 字段定义。

有关常见 I/O 任务的列表,请参阅 常见 I/O 任务

另请参阅

适用于

WriteLine(String, Object[])

使用与 Format(String, Object) 相同的语义将格式化字符串和新行写入文本流。

public:
 virtual void WriteLine(System::String ^ format, ... cli::array <System::Object ^> ^ arg);
public virtual void WriteLine (string format, params 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

复合格式字符串。

arg
Object[]

一个对象数组,其中包含零个或多个要设置格式和写入的对象。

例外

字符串或对象作为 null 传入。

出现 I/O 错误。

format 不是有效的复合格式字符串。

  • 或 - 格式项的索引小于 0(零),或者大于或等于 arg 数组的长度。

注解

此方法使用复合格式将对象的值转换为其字符串表示形式,并在字符串中嵌入该表示形式。 .NET 提供广泛的格式支持,在以下格式设置主题中更详细地描述了这些支持:

format 参数包含与零个或多个索引占位符(称为格式项)混合的文本运行,这些占位符与此方法的参数列表中的对象相对应。 格式设置过程将每个格式项替换为相应对象的值的字符串表示形式。

格式项的语法如下所示:

{index[,length][:formatString]}

括号中的元素是可选的。 下表对每个元素进行了描述。 有关复合格式设置功能的详细信息,包括格式项的语法,请参阅 复合格式设置

元素 说明
索引 要设置格式的对象参数列表中的从零开始的位置。 如果 索引 指定的对象是 null,则格式项将被 String.Empty替换。 由于此重载在其参数列表中具有数组, 因此索引 的值必须始终小于数组的长度。 如果 索引 位置中没有参数,则会引发一个 FormatException
length 参数的字符串表示形式的最小字符数。 如果为正,则参数右对齐;如果为负,则为左对齐。
formatString 要格式化的对象支持的标准或自定义格式字符串。 formatString 的可能值与对象ToString(string format)方法支持的值相同。 如果未指定 formatString 并且要格式化的对象实现IFormattable接口,null则作为用作IFormattable.ToString格式字符串的参数的值format传递。

前导和尾部大括号字符“{”和“}”是必需的。 若要在中 format指定单个文本大括号字符,请指定两个前导或尾随大括号;即“{{”或“}}”。

此方法不搜索指定字符串以查找 (十六进制0x000a) 的单个换行字符,并将其替换为 NewLine

如果未在格式字符串中引用指定对象,则忽略该对象。

行终止符由 CoreNewLine 字段定义。

有关常见 I/O 任务的列表,请参阅 常见 I/O 任务

另请参阅

适用于

WriteLine(String, Object)

使用与 Format(String, Object) 方法相同的语义将格式化字符串和新行写入文本流。

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

复合格式字符串。

arg0
Object

要格式化和写入的对象。

例外

formatnull

出现 I/O 错误。

format 不是有效的复合格式字符串。

  • 或 - 格式项的索引小于 0 (0)、或大于或等于要设置格式的对象数 (用于该方法重载,为一)。

注解

此方法使用复合格式将对象的值转换为其字符串表示形式,并在字符串中嵌入该表示形式。 .NET 提供广泛的格式支持,在以下格式设置主题中更详细地描述了这些支持:

format 参数包含与零个或多个索引占位符(称为格式项)混合的文本运行,这些占位符与此方法的参数列表中的对象相对应。 格式设置过程将每个格式项替换为相应对象的值的字符串表示形式。

格式项的语法如下所示:

{index[,length][:formatString]}

括号中的元素是可选的。 下表对每个元素进行了描述。 有关复合格式设置功能的详细信息,包括格式项的语法,请参阅 复合格式设置

元素 说明
索引 要设置格式的对象参数列表中的从零开始的位置。 如果 索引 指定的对象是 null,则格式项将被 String.Empty替换。 由于此重载在其参数列表中只有一个对象, 因此索引 的值必须始终为 0。 如果 索引 位置中没有参数,则会引发一个 FormatException
length 参数的字符串表示形式的最小字符数。 如果为正,则参数右对齐;如果为负,则为左对齐。
formatString 要格式化的对象支持的标准或自定义格式字符串。 formatString 的可能值与对象ToString(string format)方法支持的值相同。 如果未指定 formatString 并且要格式化的对象实现IFormattable接口,null则作为用作IFormattable.ToString格式字符串的参数的值format传递。

前导和尾部大括号字符“{”和“}”是必需的。 若要在中 format指定单个文本大括号字符,请指定两个前导或尾随大括号;即“{{”或“}}”。

此方法不搜索指定字符串以查找 (十六进制0x000a) 的单个换行字符,并将其替换为 NewLine

如果未在格式字符串中引用指定对象,则忽略该对象。

行终止符由 CoreNewLine 字段定义。

有关常见 I/O 任务的列表,请参阅 常见 I/O 任务

另请参阅

适用于

WriteLine(UInt64)

重要

此 API 不符合 CLS。

将 8 字节无符号整数的文本表示形式写入文本流,后跟行终止符。

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

参数

value
UInt64

要写入的 8 字节无符号整数。

属性

例外

出现 I/O 错误。

注解

指定值的文本表示形式通过调用 UInt64.ToString 方法生成。 如果不是null,则FormatProvider属性指定区域性特定的格式。

行终止符由 CoreNewLine 字段定义。

有关常见 I/O 任务的列表,请参阅 常见 I/O 任务

另请参阅

适用于

WriteLine(UInt32)

重要

此 API 不符合 CLS。

将 4 字节无符号整数的文本表示形式写入文本流,后跟行终止符。

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

参数

value
UInt32

要写入的 4 字节无符号整数。

属性

例外

出现 I/O 错误。

注解

指定值的文本表示形式通过调用 UInt32.ToString 方法生成。 如果不是null,则FormatProvider属性指定区域性特定的格式。

行终止符由 CoreNewLine 字段定义。

有关常见 I/O 任务的列表,请参阅 常见 I/O 任务

另请参阅

适用于

WriteLine(String, Object, Object, Object)

使用与 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);
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

复合格式字符串。

arg0
Object

要格式化和写入的第一个对象。

arg1
Object

要格式化和写入的第二个对象。

arg2
Object

要设置格式和写入的第三个对象。

例外

formatnull

出现 I/O 错误。

format 不是有效的复合格式字符串。

  • 或 - 格式项的索引小于 0 (0)、或大于或等于要设置格式的对象数 (用于该方法重载,为三)。

注解

此方法使用复合格式将对象的值转换为其字符串表示形式,并在字符串中嵌入该表示形式。 .NET 提供广泛的格式支持,在以下格式设置主题中更详细地描述了这些支持:

format 参数包含与零个或多个索引占位符(称为格式项)混合的文本运行,这些占位符与此方法的参数列表中的对象相对应。 格式设置过程将每个格式项替换为相应对象的值的字符串表示形式。

格式项的语法如下所示:

{index[,length][:formatString]}

括号中的元素是可选的。 下表对每个元素进行了描述。 有关复合格式设置功能的详细信息,包括格式项的语法,请参阅 复合格式设置

元素 说明
索引 要设置格式的对象参数列表中的从零开始的位置。 如果 索引 指定的对象是 null,则格式项将被 String.Empty替换。 由于此重载在其参数列表中有三个对象, 因此索引 的值必须始终为 0、1 或 2。 如果 索引 位置中没有参数,则会引发一个 FormatException
length 参数的字符串表示形式的最小字符数。 如果为正,则参数右对齐;如果为负,则为左对齐。
formatString 要格式化的对象支持的标准或自定义格式字符串。 formatString 的可能值与对象ToString(string format)方法支持的值相同。 如果未指定 formatString 并且要格式化的对象实现IFormattable接口,null则作为用作IFormattable.ToString格式字符串的参数的值format传递。

前导和尾部大括号字符“{”和“}”是必需的。 若要在中 format指定单个文本大括号字符,请指定两个前导或尾随大括号;即“{{”或“}}”。

此方法不搜索指定字符串以查找 (十六进制0x000a) 的单个换行字符,并将其替换为 NewLine

如果未在格式字符串中引用指定对象,则忽略该对象。

行终止符由 CoreNewLine 字段定义。

有关常见 I/O 任务的列表,请参阅 常见 I/O 任务

另请参阅

适用于

WriteLine(StringBuilder)

将字符串生成器的文本表示形式写入文本流,后跟行终止符。

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

要作为字符串生成器写入文本流的字符串。

注解

指定值的文本表示形式通过调用 StringBuilder.ToString 方法生成。

行终止符由 CoreNewLine 字段定义。

有关常见 I/O 任务的列表,请参阅 常见 I/O 任务

适用于

WriteLine(String)

将字符串写入文本流,后跟行终止符。

public:
 virtual void WriteLine(System::String ^ value);
public virtual void WriteLine (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

要写入的字符串。 如果 valuenull,则只写入行终止符。

例外

出现 I/O 错误。

注解

此重载等效于 Write(Char[]) 重载。

行终止符由 CoreNewLine 字段定义。

此方法不搜索指定字符串以查找 (十六进制0x000a) 的单个换行字符,并将其替换为 NewLine

有关常见 I/O 任务的列表,请参阅 常见 I/O 任务

另请参阅

适用于

WriteLine(Single)

将 4 字节浮点值的文本表示形式写入文本流,后跟行终止符。

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 字节浮点值。

例外

出现 I/O 错误。

注解

如果不是null,则FormatProvider属性指定区域性特定的格式。 有关常见 I/O 任务的列表,请参阅 常见 I/O 任务

行终止符由 CoreNewLine 字段定义。

另请参阅

适用于

WriteLine(Double)

将 8 字节浮点值的文本表示形式写入文本流,后跟行终止符。

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 字节浮点值。

例外

出现 I/O 错误。

注解

如果不是null,则FormatProvider属性指定区域性特定的格式。 有关常见 I/O 任务的列表,请参阅 常见 I/O 任务

行终止符由 CoreNewLine 字段定义。

另请参阅

适用于

WriteLine(Object)

通过在对象上调用 ToString 方法将此对象的文本表示形式写入文本流,后跟行终止符。

public:
 virtual void WriteLine(System::Object ^ value);
public virtual void WriteLine (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

要写入的对象。 如果 valuenull,则只写入行终止符。

例外

出现 I/O 错误。

注解

此重载等效于 Write(String, Object) 重载。 如果不是null,则FormatProvider属性指定区域性特定的格式。

行终止符由 CoreNewLine 字段定义。

有关常见 I/O 任务的列表,请参阅 常见 I/O 任务

另请参阅

适用于

WriteLine(Int64)

将 8 字节带符号整数的文本表示形式写入文本流,后跟行终止符。

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 字节有符号整数。

例外

出现 I/O 错误。

注解

指定值的文本表示形式通过调用 Int64.ToString 方法生成。 如果不是null,则TextWriter.FormatProvider属性指定区域性特定的格式。

行终止符由 CoreNewLine 字段定义。

有关常见 I/O 任务的列表,请参阅 常见 I/O 任务

另请参阅

适用于

WriteLine(Int32)

将 4 字节带符号整数的文本表示形式写入文本流,后跟行终止符。

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 字节有符号整数。

例外

出现 I/O 错误。

注解

指定值的文本表示形式通过调用 Int32.ToString 方法生成。 如果不是null,则TextWriter.FormatProvider属性指定区域性特定的格式。

行终止符由 CoreNewLine 字段定义。

有关常见 I/O 任务的列表,请参阅 常见 I/O 任务

另请参阅

适用于

WriteLine(Decimal)

将小数值的文本表示形式写入文本流,后跟行终止符。

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

要写入的十进制值。

例外

出现 I/O 错误。

注解

如果不是null,则FormatProvider属性指定区域性特定的格式。 有关常见 I/O 任务的列表,请参阅 常见 I/O 任务

行终止符由 CoreNewLine 字段定义。

另请参阅

适用于

WriteLine(Char[])

将字符数组写入文本流,后跟行终止符。

public:
 virtual void WriteLine(cli::array <char> ^ buffer);
public virtual void WriteLine (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[]

从其读取数据的字符数组。

例外

出现 I/O 错误。

注解

所有字符 buffer 都写入基础流。 如果字符数组为 null,则仅写入行结束符。

此重载等效于 Write(Char[]) 后跟 WriteLine()

行终止符由 CoreNewLine 字段定义。

有关常见 I/O 任务的列表,请参阅 常见 I/O 任务

另请参阅

适用于

WriteLine(Char)

将字符写入文本流,后跟行终止符。

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

要写入文本流中的字符。

例外

出现 I/O 错误。

注解

此重载等效于 Write(Char) 后跟 WriteLine()

行终止符由 CoreNewLine 字段定义。

有关常见 I/O 任务的列表,请参阅 常见 I/O 任务

另请参阅

适用于

WriteLine(Boolean)

Boolean 值的文本表示形式写入文本流,后跟行终止符。

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 值。

例外

出现 I/O 错误。

注解

指定值的文本表示形式通过调用 Boolean.ToString 方法生成。

此方法输出或Boolean.TrueStringBoolean.FalseString输出 。

行终止符由 CoreNewLine 字段定义。

有关常见 I/O 任务的列表,请参阅 常见 I/O 任务

另请参阅

适用于

WriteLine()

将行终止符写入文本流。

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

例外

出现 I/O 错误。

注解

行终止符由 CoreNewLine 字段定义。

有关常见 I/O 任务的列表,请参阅 常见 I/O 任务

另请参阅

适用于

WriteLine(ReadOnlySpan<Char>)

将字符范围的文本表示形式写入文本流,后跟行终止符。

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>

要写入文本流中的字符范围值。

注解

指定值的文本表示形式通过调用 ReadOnlySpan<Char> 生成。ToString 方法。

行终止符由 CoreNewLine 字段定义。

有关常见 I/O 任务的列表,请参阅 常见 I/O 任务

适用于