TextWriter.WriteLine 方法

定義

命名空間:

System.IO

組件:

System.Runtime.dll

將數據寫入文字數據流，後面接著行終止符。

多載

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(String, Object, Object, Object)	使用與 Format(String, Object)相同的語意，將格式化字串和新行寫出至文字數據流。
WriteLine(UInt32)	將 4 位元組無符號整數的文字表示寫入文字數據流，後面接著行終止符。
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)

來源:

TextWriter.cs

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

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

要格式化和寫入的第二個物件。

例外狀況

ArgumentNullException

format null。

ObjectDisposedException

TextWriter 已關閉。

IOException

發生 I/O 錯誤。

FormatException

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

-或-

格式專案的索引小於 0（零），或大於或等於要格式化的物件數目（此方法多載為兩個）。

備註

這個方法會使用複合格式，將物件的值轉換成其字串表示法，並將該表示法內嵌在字串中。 .NET 提供廣泛的格式支援，如下列格式化主題中更詳細地說明：

• 如需複合格式設定功能的詳細資訊，請參閱 複合格式設定。

• 如需數值格式規範的詳細資訊，請參閱 標準數值格式字串 和 自定義數值格式字串。

• 如需日期和時間格式規範的詳細資訊，請參閱 標準日期和時間格式字串 和 自定義日期和時間格式字串。

• 如需列舉格式規範的詳細資訊，請參閱 列舉格式字串。

• 如需格式化的詳細資訊，請參閱 格式化類型。

format 參數包含零或多個文字執行，與零或多個索引佔位元混合，稱為格式項目，對應至此方法參數清單中的物件。 格式化程式會將每個格式專案取代為對應物件值的字串表示。

格式項目的語法如下所示：

{index[，length][：formatString]}

方括弧中的元素是選擇性的。 下表描述每個元素。 如需複合格式設定功能的詳細資訊，包括格式項目的語法，請參閱 複合格式設定。

元素	描述
指數	要格式化之物件參數清單中的以零起始的位置。 如果 索引 所指定的物件 null，則格式專案會取代為 String.Empty。 由於這個多載在其參數清單中有兩個物件，因此 索引 的值一律必須是 0 或 1。 如果 索引中沒有參數 位置，則會擲回 FormatException。
、長度	參數位符串表示中的字元數下限。 如果為正數，則參數會靠右對齊;如果為負數，則為靠左對齊。
：formatString	要格式化之物件所支援的標準或自定義格式字串。 formatString 的可能值與物件的 ToString(string format) 方法所支援的值相同。 如果未指定 formatString，而且要格式化的物件會實作 IFormattable 介面，null 會當做 IFormattable.ToString 格式字串使用的 format 參數值傳遞。

前置和尾端大括號字元 “{” 和 “}” 是必要的。 若要在 format中指定單一常值大括號字元，請指定兩個前置或尾端大括號字元：也就是 “{{” 或 “}}”。

這個方法不會搜尋指定字串中的個別換行字元（十六進位0x000a），並以 NewLine取代它們。

如果未在格式字串中參考指定的物件，則會忽略它。

行終止符是由 [CoreNewLine] 欄位所定義。

如需一般 I/O 工作的清單，請參閱 一般 I/O 工作。

另請參閱

• StreamWriter
• StringWriter
• IFormatProvider
• 檔案和串流 I/O
• 如何：從檔案讀取文字
• 如何：將文字寫入檔案

WriteLine(Char[], Int32, Int32)

來源:

TextWriter.cs

將字元的子陣列寫入文字數據流，後面接著行終止符。

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

要寫入的字元數上限。

例外狀況

ArgumentException

緩衝區長度減去 index 小於 count。

ArgumentNullException

buffer 參數是 null。

ArgumentOutOfRangeException

index 或 count 為負數。

ObjectDisposedException

TextWriter 已關閉。

IOException

發生 I/O 錯誤。

備註

這個方法會將數據 count 字元寫入這個 TextWriter，從位置 index開始的 buffer 字元陣列。

此多載相當於針對 index 與 （index + count） 之間 buffer 中的每個字元呼叫 Write(Char[]) 方法，後面接著 WriteLine。

行終止符是由 [CoreNewLine] 欄位所定義。

如需一般 I/O 工作的清單，請參閱 一般 I/O 工作。

另請參閱

• StreamWriter
• StringWriter
• 檔案和串流 I/O
• 如何：從檔案讀取文字
• 如何：將文字寫入檔案

WriteLine(String, Object[])

來源:

TextWriter.cs

使用與 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

複合格式字串。

arg

Object[]

對象陣列，包含零個或多個要格式化和寫入的物件。

例外狀況

ArgumentNullException

字串或物件會以 null的形式傳入。

ObjectDisposedException

TextWriter 已關閉。

IOException

發生 I/O 錯誤。

FormatException

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

-或-

格式專案的索引小於0（零），或大於或等於 arg 陣列的長度。

備註

這個方法會使用複合格式，將物件的值轉換成其字串表示法，並將該表示法內嵌在字串中。 .NET 提供廣泛的格式支援，如下列格式化主題中更詳細地說明：

• 如需複合格式設定功能的詳細資訊，請參閱 複合格式設定。

• 如需數值格式規範的詳細資訊，請參閱 標準數值格式字串 和 自定義數值格式字串。

• 如需日期和時間格式規範的詳細資訊，請參閱 標準日期和時間格式字串 和 自定義日期和時間格式字串。

• 如需列舉格式規範的詳細資訊，請參閱 列舉格式字串。

• 如需格式化的詳細資訊，請參閱 格式化類型。

format 參數包含零或多個文字執行，與零或多個索引佔位元混合，稱為格式項目，對應至此方法參數清單中的物件。 格式化程式會將每個格式專案取代為對應物件值的字串表示。

格式項目的語法如下所示：

{index[，length][：formatString]}

方括弧中的元素是選擇性的。 下表描述每個元素。 如需複合格式設定功能的詳細資訊，包括格式項目的語法，請參閱 複合格式設定。

元素	描述
指數	要格式化之物件參數清單中的以零起始的位置。 如果 索引 所指定的物件 null，則格式專案會取代為 String.Empty。 由於這個多載在其參數清單中具有數位，因此 索引 的值必須永遠小於陣列的長度。 如果 索引中沒有參數 位置，則會擲回 FormatException。
、長度	參數位符串表示中的字元數下限。 如果為正數，則參數會靠右對齊;如果為負數，則為靠左對齊。
：formatString	要格式化之物件所支援的標準或自定義格式字串。 formatString 的可能值與物件的 ToString(string format) 方法所支援的值相同。 如果未指定 formatString，而且要格式化的物件會實作 IFormattable 介面，null 會當做 IFormattable.ToString 格式字串使用的 format 參數值傳遞。

前置和尾端大括號字元 “{” 和 “}” 是必要的。 若要在 format中指定單一常值大括號字元，請指定兩個前置或尾端大括號字元：也就是 “{{” 或 “}}”。

這個方法不會搜尋指定字串中的個別換行字元（十六進位0x000a），並以 NewLine取代它們。

如果未在格式字串中參考指定的物件，則會忽略它。

行終止符是由 [CoreNewLine] 欄位所定義。

如需一般 I/O 工作的清單，請參閱 一般 I/O 工作。

另請參閱

• StreamWriter
• StringWriter
• IFormatProvider
• 檔案和串流 I/O
• 如何：從檔案讀取文字
• 如何：將文字寫入檔案

WriteLine(String, Object)

來源:

TextWriter.cs

使用與 Format(String, Object) 方法相同的語意，將格式化字串和新行寫入文字數據流。

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

複合格式字串。

arg0

Object

要格式化和寫入的物件。

例外狀況

ArgumentNullException

format null。

ObjectDisposedException

TextWriter 已關閉。

IOException

發生 I/O 錯誤。

FormatException

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

-或-

格式專案的索引小於 0（零），或大於或等於要格式化的物件數目（此方法多載為一個）。

備註

這個方法會使用複合格式，將物件的值轉換成其字串表示法，並將該表示法內嵌在字串中。 .NET 提供廣泛的格式支援，如下列格式化主題中更詳細地說明：

• 如需複合格式設定功能的詳細資訊，請參閱 複合格式設定。

• 如需數值格式規範的詳細資訊，請參閱 標準數值格式字串 和 自定義數值格式字串。

• 如需日期和時間格式規範的詳細資訊，請參閱 標準日期和時間格式字串 和 自定義日期和時間格式字串。

• 如需列舉格式規範的詳細資訊，請參閱 列舉格式字串。

• 如需格式化的詳細資訊，請參閱 格式化類型。

format 參數包含零或多個文字執行，與零或多個索引佔位元混合，稱為格式項目，對應至此方法參數清單中的物件。 格式化程式會將每個格式專案取代為對應物件值的字串表示。

格式項目的語法如下所示：

{index[，length][：formatString]}

方括弧中的元素是選擇性的。 下表描述每個元素。 如需複合格式設定功能的詳細資訊，包括格式項目的語法，請參閱 複合格式設定。

元素	描述
指數	要格式化之物件參數清單中的以零起始的位置。 如果 索引 所指定的物件 null，則格式專案會取代為 String.Empty。 由於這個多載在其參數清單中只有單一物件，因此 索引 的值一律必須為 0。 如果 索引中沒有參數 位置，則會擲回 FormatException。
、長度	參數位符串表示中的字元數下限。 如果為正數，則參數會靠右對齊;如果為負數，則為靠左對齊。
：formatString	要格式化之物件所支援的標準或自定義格式字串。 formatString 的可能值與物件的 ToString(string format) 方法所支援的值相同。 如果未指定 formatString，而且要格式化的物件會實作 IFormattable 介面，null 會當做 IFormattable.ToString 格式字串使用的 format 參數值傳遞。

前置和尾端大括號字元 “{” 和 “}” 是必要的。 若要在 format中指定單一常值大括號字元，請指定兩個前置或尾端大括號字元：也就是 “{{” 或 “}}”。

這個方法不會搜尋指定字串中的個別換行字元（十六進位0x000a），並以 NewLine取代它們。

如果未在格式字串中參考指定的物件，則會忽略它。

行終止符是由 [CoreNewLine] 欄位所定義。

如需一般 I/O 工作的清單，請參閱 一般 I/O 工作。

另請參閱

• StreamWriter
• StringWriter
• IFormatProvider
• 檔案和串流 I/O
• 如何：從檔案讀取文字
• 如何：將文字寫入檔案

WriteLine(UInt64)

來源:

TextWriter.cs

重要

此 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位元組無符號整數。

屬性

CLSCompliantAttribute

例外狀況

ObjectDisposedException

TextWriter 已關閉。

IOException

發生 I/O 錯誤。

備註

所指定值的文字表示法是由呼叫 UInt64.ToString 方法所產生。 如果不是 null，則 FormatProvider 屬性會指定特定文化特性的格式。

行終止符是由 [CoreNewLine] 欄位所定義。

如需一般 I/O 工作的清單，請參閱 一般 I/O 工作。

另請參閱

• StreamWriter
• StringWriter
• IFormatProvider
• 檔案和串流 I/O
• 如何：從檔案讀取文字
• 如何：將文字寫入檔案

WriteLine(String, Object, Object, Object)

來源:

TextWriter.cs

使用與 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

複合格式字串。

arg0

Object

要格式化和寫入的第一個物件。

arg1

Object

要格式化和寫入的第二個物件。

arg2

Object

要格式化和寫入的第三個物件。

例外狀況

ArgumentNullException

format null。

ObjectDisposedException

TextWriter 已關閉。

IOException

發生 I/O 錯誤。

FormatException

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

-或-

格式專案的索引小於 0（零），或大於或等於要格式化的物件數目（此方法多載為 3 個）。

備註

這個方法會使用複合格式，將物件的值轉換成其字串表示法，並將該表示法內嵌在字串中。 .NET 提供廣泛的格式支援，如下列格式化主題中更詳細地說明：

• 如需複合格式設定功能的詳細資訊，請參閱 複合格式設定。

• 如需數值格式規範的詳細資訊，請參閱 標準數值格式字串 和 自定義數值格式字串。

• 如需日期和時間格式規範的詳細資訊，請參閱 標準日期和時間格式字串 和 自定義日期和時間格式字串。

• 如需列舉格式規範的詳細資訊，請參閱 列舉格式字串。

• 如需格式化的詳細資訊，請參閱 格式化類型。

format 參數包含零或多個文字執行，與零或多個索引佔位元混合，稱為格式項目，對應至此方法參數清單中的物件。 格式化程式會將每個格式專案取代為對應物件值的字串表示。

格式項目的語法如下所示：

{index[，length][：formatString]}

方括弧中的元素是選擇性的。 下表描述每個元素。 如需複合格式設定功能的詳細資訊，包括格式項目的語法，請參閱 複合格式設定。

元素	描述
指數	要格式化之物件參數清單中的以零起始的位置。 如果 索引 所指定的物件 null，則格式專案會取代為 String.Empty。 由於這個多載在其參數清單中有三個物件，因此 索引 的值一律必須是 0、1 或 2。 如果 索引中沒有參數 位置，則會擲回 FormatException。
、長度	參數位符串表示中的字元數下限。 如果為正數，則參數會靠右對齊;如果為負數，則為靠左對齊。
：formatString	要格式化之物件所支援的標準或自定義格式字串。 formatString 的可能值與物件的 ToString(string format) 方法所支援的值相同。 如果未指定 formatString，而且要格式化的物件會實作 IFormattable 介面，null 會當做 IFormattable.ToString 格式字串使用的 format 參數值傳遞。

前置和尾端大括號字元 “{” 和 “}” 是必要的。 若要在 format中指定單一常值大括號字元，請指定兩個前置或尾端大括號字元：也就是 “{{” 或 “}}”。

這個方法不會搜尋指定字串中的個別換行字元（十六進位0x000a），並以 NewLine取代它們。

如果未在格式字串中參考指定的物件，則會忽略它。

行終止符是由 [CoreNewLine] 欄位所定義。

如需一般 I/O 工作的清單，請參閱 一般 I/O 工作。

另請參閱

• StreamWriter
• StringWriter
• IFormatProvider
• 檔案和串流 I/O
• 如何：從檔案讀取文字
• 如何：將文字寫入檔案

WriteLine(UInt32)

來源:

TextWriter.cs

重要

此 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 位元組無符號整數。

屬性

CLSCompliantAttribute

例外狀況

ObjectDisposedException

TextWriter 已關閉。

IOException

發生 I/O 錯誤。

備註

所指定值的文字表示法是由呼叫 UInt32.ToString 方法所產生。 如果不是 null，則 FormatProvider 屬性會指定特定文化特性的格式。

行終止符是由 [CoreNewLine] 欄位所定義。

如需一般 I/O 工作的清單，請參閱 一般 I/O 工作。

另請參閱

• StreamWriter
• StringWriter
• IFormatProvider
• 檔案和串流 I/O
• 如何：從檔案讀取文字
• 如何：將文字寫入檔案

WriteLine(StringBuilder)

來源:

TextWriter.cs

將字串產生器的文字表示寫入文字數據流，後面接著行終止符。

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)

來源:

TextWriter.cs

將字串寫入文字數據流，後面接著行終止符。

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

要寫入的字串。 如果 value 是 null，則只會寫入行終止符。

例外狀況

ObjectDisposedException

TextWriter 已關閉。

IOException

發生 I/O 錯誤。

備註

此多載相當於 Write(Char[]) 多載。

行終止符是由 [CoreNewLine] 欄位所定義。

這個方法不會搜尋指定字串中的個別換行字元（十六進位0x000a），並以 NewLine取代它們。

如需一般 I/O 工作的清單，請參閱 一般 I/O 工作。

另請參閱

• StreamWriter
• StringWriter
• 檔案和串流 I/O
• 如何：從檔案讀取文字
• 如何：將文字寫入檔案

WriteLine(Single)

來源:

TextWriter.cs

將 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 位元組浮點值。

例外狀況

ObjectDisposedException

TextWriter 已關閉。

IOException

發生 I/O 錯誤。

備註

如果不是 null，則 FormatProvider 屬性會指定特定文化特性的格式。 如需一般 I/O 工作的清單，請參閱 一般 I/O 工作。

行終止符是由 [CoreNewLine] 欄位所定義。

另請參閱

• StreamWriter
• StringWriter
• IFormatProvider
• 檔案和串流 I/O
• 如何：從檔案讀取文字
• 如何：將文字寫入檔案

WriteLine(Double)

來源:

TextWriter.cs

將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位元組浮點值。

例外狀況

ObjectDisposedException

TextWriter 已關閉。

IOException

發生 I/O 錯誤。

備註

如果不是 null，則 FormatProvider 屬性會指定特定文化特性的格式。 如需一般 I/O 工作的清單，請參閱 一般 I/O 工作。

行終止符是由 [CoreNewLine] 欄位所定義。

另請參閱

• StreamWriter
• StringWriter
• IFormatProvider
• 檔案和串流 I/O
• 如何：從檔案讀取文字
• 如何：將文字寫入檔案

WriteLine(Object)

來源:

TextWriter.cs

呼叫該物件上的 ToString 方法，後面接著行終止符，將物件的文字表示寫入文字數據流。

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

要寫入的物件。 如果 value 是 null，則只會寫入行終止符。

例外狀況

ObjectDisposedException

TextWriter 已關閉。

IOException

發生 I/O 錯誤。

備註

此多載相當於 Write(String, Object) 多載。 如果不是 null，則 FormatProvider 屬性會指定特定文化特性的格式。

行終止符是由 [CoreNewLine] 欄位所定義。

如需一般 I/O 工作的清單，請參閱 一般 I/O 工作。

另請參閱

• StreamWriter
• StringWriter
• IFormatProvider
• 檔案和串流 I/O
• 如何：從檔案讀取文字
• 如何：將文字寫入檔案

WriteLine(Int64)

來源:

TextWriter.cs

將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位元組帶正負號整數。

例外狀況

ObjectDisposedException

TextWriter 已關閉。

IOException

發生 I/O 錯誤。

備註

所指定值的文字表示法是由呼叫 Int64.ToString 方法所產生。 如果不是 null，則 TextWriter.FormatProvider 屬性會指定特定文化特性的格式。

行終止符是由 [CoreNewLine] 欄位所定義。

如需一般 I/O 工作的清單，請參閱 一般 I/O 工作。

另請參閱

• StreamWriter
• StringWriter
• IFormatProvider
• 檔案和串流 I/O
• 如何：從檔案讀取文字
• 如何：將文字寫入檔案

WriteLine(Int32)

來源:

TextWriter.cs

將 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 位元組帶正負號整數。

例外狀況

ObjectDisposedException

TextWriter 已關閉。

IOException

發生 I/O 錯誤。

備註

所指定值的文字表示法是由呼叫 Int32.ToString 方法所產生。 如果不是 null，則 TextWriter.FormatProvider 屬性會指定特定文化特性的格式。

行終止符是由 [CoreNewLine] 欄位所定義。

如需一般 I/O 工作的清單，請參閱 一般 I/O 工作。

另請參閱

• StreamWriter
• StringWriter
• IFormatProvider
• 檔案和串流 I/O
• 如何：從檔案讀取文字
• 如何：將文字寫入檔案

WriteLine(Decimal)

來源:

TextWriter.cs

將十進位值的文字表示寫入文字數據流，後面接著行終止符。

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

要寫入的十進位值。

例外狀況

ObjectDisposedException

TextWriter 已關閉。

IOException

發生 I/O 錯誤。

備註

如果不是 null，則 FormatProvider 屬性會指定特定文化特性的格式。 如需一般 I/O 工作的清單，請參閱 一般 I/O 工作。

行終止符是由 [CoreNewLine] 欄位所定義。

另請參閱

• StreamWriter
• StringWriter
• IFormatProvider
• 檔案和串流 I/O
• 如何：從檔案讀取文字
• 如何：將文字寫入檔案

WriteLine(Char[])

來源:

TextWriter.cs

將字元陣列寫入文字數據流，後面接著行終止符。

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

讀取數據的字元陣列。

例外狀況

ObjectDisposedException

TextWriter 已關閉。

IOException

發生 I/O 錯誤。

備註

buffer 中的所有字元都會寫入基礎數據流。 如果字元陣列 null，則只會寫入行終止符。

此多載相當於 Write(Char[])，後面接著 WriteLine() 。

行終止符是由 [CoreNewLine] 欄位所定義。

如需一般 I/O 工作的清單，請參閱 一般 I/O 工作。

另請參閱

• StreamWriter
• StringWriter
• 檔案和串流 I/O
• 如何：從檔案讀取文字
• 如何：將文字寫入檔案

WriteLine(Char)

來源:

TextWriter.cs

將字元寫入文字數據流，後面接著行終止符。

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

要寫入文字數據流的字元。

例外狀況

ObjectDisposedException

TextWriter 已關閉。

IOException

發生 I/O 錯誤。

備註

此多載相當於 Write(Char)，後面接著 WriteLine() 。

行終止符是由 [CoreNewLine] 欄位所定義。

如需一般 I/O 工作的清單，請參閱 一般 I/O 工作。

另請參閱

• StreamWriter
• StringWriter
• 檔案和串流 I/O
• 如何：從檔案讀取文字
• 如何：將文字寫入檔案

WriteLine(Boolean)

來源:

TextWriter.cs

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

例外狀況

ObjectDisposedException

TextWriter 已關閉。

IOException

發生 I/O 錯誤。

備註

所指定值的文字表示法是由呼叫 Boolean.ToString 方法所產生。

這個方法會輸出 Boolean.TrueString 或 Boolean.FalseString。

行終止符是由 [CoreNewLine] 欄位所定義。

如需一般 I/O 工作的清單，請參閱 一般 I/O 工作。

另請參閱

• StreamWriter
• StringWriter
• 檔案和串流 I/O
• 如何：從檔案讀取文字
• 如何：將文字寫入檔案

WriteLine()

來源:

TextWriter.cs

將行終止符寫入文字數據流。

public:
 virtual void WriteLine();

public virtual void WriteLine ();

abstract member WriteLine : unit -> unit
override this.WriteLine : unit -> unit

Public Overridable Sub WriteLine ()

例外狀況

ObjectDisposedException

TextWriter 已關閉。

IOException

發生 I/O 錯誤。

備註

行終止符是由 [CoreNewLine] 欄位所定義。

如需一般 I/O 工作的清單，請參閱 一般 I/O 工作。

另請參閱

• StreamWriter
• StringWriter
• 檔案和串流 I/O
• 如何：從檔案讀取文字
• 如何：將文字寫入檔案

WriteLine(ReadOnlySpan<Char>)

來源:

TextWriter.cs

將字元範圍的文字表示寫入文字數據流，後面接著行終止符。

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>

要寫入文字數據流的char span 值。

備註

指定值的文字表示法是由呼叫 ReadOnlySpan<Char>所產生。ToString 方法。

行終止符是由 [CoreNewLine] 欄位所定義。

如需一般 I/O 工作的清單，請參閱 一般 I/O 工作。