TextWriter.WriteLine 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
將資料寫入文字資料流,後接行結束字元。
多載
WriteLine(String, Object, Object) |
使用與 Format(String, Object, Object) 方法相同的語意,將格式化字串和新行寫入文字資料流。 |
WriteLine(Char[], Int32, Int32) |
將字元的子陣列寫入文字資料流,後接行結束字元。 |
WriteLine(String, ReadOnlySpan<Object>) | |
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) |
藉由呼叫該物件上的 |
WriteLine(Int64) |
將 8 位元組帶正負號的整數文字表示寫入文字資料流,後接行結束字元。 |
WriteLine(Int32) |
將 4 位元組帶正負號的整數文字表示寫入文字資料流,後接行結束字元。 |
WriteLine(Decimal) |
將十進位值的文字表示寫入文字資料流,後接行結束字元。 |
WriteLine(Char[]) |
將字元的陣列寫入文字資料流,後接行結束字元。 |
WriteLine(Char) |
將字元寫入文字資料流,後接行結束字元。 |
WriteLine(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
第二個要格式化和寫入的物件。
例外狀況
format
為 null
。
發生 I/O 錯誤。
備註
這個方法會使用複合格式,將物件的值轉換成其字串表示,並將該表示內嵌在字串中。 .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 工作。
另請參閱
適用於
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
。
index
或 count
為負。
發生 I/O 錯誤。
備註
這個方法會從位置 index
開始,從buffer
字元陣列將數據字元寫入count
這個TextWriter
中。
這個多載相當於針對 和 () + index
count
中的每個index
字元buffer
呼叫 Write(Char[]) 方法。WriteLine
行結束字元是由 CoreNewLine 欄位所定義。
如需一般 I/O 工作的清單,請參閱 一般 I/O 工作。
另請參閱
適用於
WriteLine(String, ReadOnlySpan<Object>)
public:
virtual void WriteLine(System::String ^ format, ReadOnlySpan<System::Object ^> arg);
public virtual void WriteLine (string format, scoped ReadOnlySpan<object?> arg);
abstract member WriteLine : string * ReadOnlySpan<obj> -> unit
override this.WriteLine : string * ReadOnlySpan<obj> -> unit
Public Overridable Sub WriteLine (format As String, arg As ReadOnlySpan(Of Object))
參數
- format
- String
- arg
- ReadOnlySpan<Object>
適用於
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 錯誤。
備註
這個方法會使用複合格式,將物件的值轉換成其字串表示法,以及在字串中內嵌該表示法。 .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 工作。
另請參閱
適用於
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
要格式化及寫入的物件。
例外狀況
format
為 null
。
發生 I/O 錯誤。
備註
這個方法會使用複合格式,將物件的值轉換成其字串表示法,以及在字串中內嵌該表示法。 .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 工作。
另請參閱
適用於
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(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
第三個要格式化和寫入的物件。
例外狀況
format
為 null
。
發生 I/O 錯誤。
備註
這個方法會使用複合格式,將物件的值轉換成其字串表示法,以及在字串中內嵌該表示法。 .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 工作。
另請參閱
適用於
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(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
要寫入的字串。 如果 value
為 null
,只寫入行結束字元。
例外狀況
發生 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
要寫入的物件。 如果 value
為 null
,只寫入行結束字元。
例外狀況
發生 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.TrueString 或 Boolean.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 工作。
適用於
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應