TextWriter.Write 方法

定義

命名空間:

System.IO

組件:

System.Runtime.dll

將數據寫入文字數據流。

多載

Write(String, Object, Object, Object)	使用與 Format(String, Object, Object, Object) 方法相同的語意，將格式化字串寫入文字數據流。
Write(Char[], Int32, Int32)	將字元的子陣列寫入文字數據流。
Write(String, Object[])	使用與 Format(String, Object[]) 方法相同的語意，將格式化字串寫入文字數據流。
Write(String, Object)	使用與 Format(String, Object) 方法相同的語意，將格式化字串寫入文字數據流。
Write(UInt64)	將8位元組無符號整數的文字表示寫入文字數據流。
Write(UInt32)	將 4 位元組無符號整數的文字表示寫入文字數據流。
Write(StringBuilder)	將字串產生器寫入至文字數據流。
Write(String)	將字串寫入文字數據流。
Write(Single)	將 4 位元組浮點值的文字表示寫入文字數據流。
Write(String, Object, Object)	使用與 Format(String, Object, Object) 方法相同的語意，將格式化字串寫入文字數據流。
Write(Object)	呼叫該物件上的 ToString 方法，將 物件的文字表示寫入文字數據流。
Write(Int64)	將8位元組帶正負號整數的文字表示寫入文字數據流。
Write(Int32)	將 4 位元組帶正負號整數的文字表示寫入文字數據流。
Write(Double)	將8位元組浮點值的文字表示寫入文字數據流。
Write(Decimal)	將十進位值的文字表示寫入文字數據流。
Write(Char[])	將字元陣列寫入文字數據流。
Write(Char)	將字元寫入文字數據流。
Write(Boolean)	將 Boolean 值的文字表示寫入文字數據流。
Write(ReadOnlySpan<Char>)	將字元範圍寫入文字數據流。

Write(String, Object, Object, Object)

來源:

TextWriter.cs

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

public:
 virtual void Write(System::String ^ format, System::Object ^ arg0, System::Object ^ arg1, System::Object ^ arg2);

public virtual void Write (string format, object? arg0, object? arg1, object? arg2);

abstract member Write : string * obj * obj * obj -> unit
override this.Write : string * obj * obj * obj -> unit

Public Overridable Sub Write (format As String, arg0 As Object, arg1 As Object, arg2 As Object)

參數

format

String

複合格式字串。

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），並以 TextWriter.NewLine取代它們。

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

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

另請參閱

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

Write(Char[], Int32, Int32)

來源:

TextWriter.cs

將字元的子陣列寫入文字數據流。

public:
 virtual void Write(cli::array <char> ^ buffer, int index, int count);

public virtual void Write (char[] buffer, int index, int count);

abstract member Write : char[] * int * int -> unit
override this.Write : char[] * int * int -> unit

Public Overridable Sub Write (buffer As Char(), index As Integer, count As Integer)

參數

buffer

Char[]

要從中寫入數據的字元陣列。

index

Int32

要開始擷取數據的緩衝區中的字元位置。

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[]) 多載。

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

另請參閱

• Write(Char[], Int32, Int32)
• Write(Char[], Int32, Int32)
• 檔案和串流 I/O
• 如何：從檔案讀取文字
• 如何：將文字寫入檔案

Write(String, Object[])

來源:

TextWriter.cs

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

public:
 virtual void Write(System::String ^ format, ... cli::array <System::Object ^> ^ arg);

public virtual void Write (string format, params object?[] arg);

abstract member Write : string * obj[] -> unit
override this.Write : string * obj[] -> unit

Public Overridable Sub Write (format As String, ParamArray arg As Object())

參數

format

String

複合格式字串。

arg

Object[]

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

例外狀況

ArgumentNullException

format 或 argnull。

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），並以 TextWriter.NewLine取代它們。

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

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

另請參閱

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

Write(String, Object)

來源:

TextWriter.cs

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

public:
 virtual void Write(System::String ^ format, System::Object ^ arg0);

public virtual void Write (string format, object? arg0);

abstract member Write : string * obj -> unit
override this.Write : string * obj -> unit

Public Overridable Sub Write (format As String, arg0 As Object)

參數

format

String

複合格式字串。

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），並以 TextWriter.NewLine取代它們。

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

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

另請參閱

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

Write(UInt64)

來源:

TextWriter.cs

重要

此 API 不符合 CLS 規範。

將8位元組無符號整數的文字表示寫入文字數據流。

public:
 virtual void Write(System::UInt64 value);

[System.CLSCompliant(false)]
public virtual void Write (ulong value);

[<System.CLSCompliant(false)>]
abstract member Write : uint64 -> unit
override this.Write : uint64 -> unit

Public Overridable Sub Write (value As ULong)

參數

value

UInt64

要寫入的8位元組無符號整數。

屬性

CLSCompliantAttribute

例外狀況

ObjectDisposedException

TextWriter 已關閉。

IOException

發生 I/O 錯誤。

備註

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

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

另請參閱

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

Write(UInt32)

來源:

TextWriter.cs

重要

此 API 不符合 CLS 規範。

將 4 位元組無符號整數的文字表示寫入文字數據流。

public:
 virtual void Write(System::UInt32 value);

[System.CLSCompliant(false)]
public virtual void Write (uint value);

[<System.CLSCompliant(false)>]
abstract member Write : uint32 -> unit
override this.Write : uint32 -> unit

Public Overridable Sub Write (value As UInteger)

參數

value

UInt32

要寫入的 4 位元組無符號整數。

屬性

CLSCompliantAttribute

例外狀況

ObjectDisposedException

TextWriter 已關閉。

IOException

發生 I/O 錯誤。

備註

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

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

另請參閱

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

Write(StringBuilder)

來源:

TextWriter.cs

將字串產生器寫入至文字數據流。

public:
 virtual void Write(System::Text::StringBuilder ^ value);

public virtual void Write (System.Text.StringBuilder? value);

abstract member Write : System.Text.StringBuilder -> unit
override this.Write : System.Text.StringBuilder -> unit

Public Overridable Sub Write (value As StringBuilder)

參數

value

StringBuilder

字串，做為字串產生器，要寫入至文字數據流。

備註

這個方法相當於 Write(stringBuilder.ToString())，但它會使用 StringBuilder.GetChunks 方法來避免建立中繼字串。

Write(String)

來源:

TextWriter.cs

將字串寫入文字數據流。

public:
 virtual void Write(System::String ^ value);

public virtual void Write (string? value);

abstract member Write : string -> unit
override this.Write : string -> unit

Public Overridable Sub Write (value As String)

參數

value

String

要寫入的字串。

例外狀況

ObjectDisposedException

TextWriter 已關閉。

IOException

發生 I/O 錯誤。

備註

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

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

如果 value 是 null，則不會寫入文字數據流。

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

另請參閱

• Write(String)
• Write(String)
• 檔案和串流 I/O
• 如何：從檔案讀取文字
• 如何：將文字寫入檔案

Write(Single)

來源:

TextWriter.cs

將 4 位元組浮點值的文字表示寫入文字數據流。

public:
 virtual void Write(float value);

public virtual void Write (float value);

abstract member Write : single -> unit
override this.Write : single -> unit

Public Overridable Sub Write (value As Single)

參數

value

Single

要寫入的 4 位元組浮點值。

例外狀況

ObjectDisposedException

TextWriter 已關閉。

IOException

發生 I/O 錯誤。

備註

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

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

另請參閱

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

Write(String, Object, Object)

來源:

TextWriter.cs

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

public:
 virtual void Write(System::String ^ format, System::Object ^ arg0, System::Object ^ arg1);

public virtual void Write (string format, object? arg0, object? arg1);

abstract member Write : string * obj * obj -> unit
override this.Write : string * obj * obj -> unit

Public Overridable Sub Write (format As String, arg0 As Object, arg1 As Object)

參數

format

String

複合格式字串。

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），並以 TextWriter.NewLine取代它們。

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

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

另請參閱

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

Write(Object)

來源:

TextWriter.cs

呼叫該物件上的 ToString 方法，將 物件的文字表示寫入文字數據流。

public:
 virtual void Write(System::Object ^ value);

public virtual void Write (object? value);

abstract member Write : obj -> unit
override this.Write : obj -> unit

Public Overridable Sub Write (value As Object)

參數

value

Object

要寫入的物件。

例外狀況

ObjectDisposedException

TextWriter 已關閉。

IOException

發生 I/O 錯誤。

備註

此多載相當於 Write(String) 多載。

如果指定的物件 null，則不會採取任何動作，也不會擲回例外狀況。 否則，會呼叫 物件的 ToString 方法來產生字串表示法，然後產生的字串會寫入輸出數據流。 如果不是 null，則 FormatProvider 屬性會指定特定文化特性的格式。

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

另請參閱

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

Write(Int64)

來源:

TextWriter.cs

將8位元組帶正負號整數的文字表示寫入文字數據流。

public:
 virtual void Write(long value);

public virtual void Write (long value);

abstract member Write : int64 -> unit
override this.Write : int64 -> unit

Public Overridable Sub Write (value As Long)

參數

value

Int64

要寫入的8位元組帶正負號整數。

例外狀況

ObjectDisposedException

TextWriter 已關閉。

IOException

發生 I/O 錯誤。

備註

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

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

如何：將文字寫入檔案

另請參閱

• StreamWriter
• StringWriter
• IFormatProvider

Write(Int32)

來源:

TextWriter.cs

將 4 位元組帶正負號整數的文字表示寫入文字數據流。

public:
 virtual void Write(int value);

public virtual void Write (int value);

abstract member Write : int -> unit
override this.Write : int -> unit

Public Overridable Sub Write (value As Integer)

參數

value

Int32

要寫入的 4 位元組帶正負號整數。

例外狀況

ObjectDisposedException

TextWriter 已關閉。

IOException

發生 I/O 錯誤。

備註

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

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

另請參閱

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

Write(Double)

來源:

TextWriter.cs

將8位元組浮點值的文字表示寫入文字數據流。

public:
 virtual void Write(double value);

public virtual void Write (double value);

abstract member Write : double -> unit
override this.Write : double -> unit

Public Overridable Sub Write (value As Double)

參數

value

Double

要寫入的8位元組浮點值。

例外狀況

ObjectDisposedException

TextWriter 已關閉。

IOException

發生 I/O 錯誤。

備註

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

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

另請參閱

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

Write(Decimal)

來源:

TextWriter.cs

將十進位值的文字表示寫入文字數據流。

public:
 virtual void Write(System::Decimal value);

public virtual void Write (decimal value);

abstract member Write : decimal -> unit
override this.Write : decimal -> unit

Public Overridable Sub Write (value As Decimal)

參數

value

Decimal

要寫入的十進位值。

例外狀況

ObjectDisposedException

TextWriter 已關閉。

IOException

發生 I/O 錯誤。

備註

如果不是 null，則 FormatProvider 屬性會指定特定文化特性的格式。

另請參閱

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

Write(Char[])

來源:

TextWriter.cs

將字元陣列寫入文字數據流。

public:
 virtual void Write(cli::array <char> ^ buffer);

public virtual void Write (char[]? buffer);

abstract member Write : char[] -> unit
override this.Write : char[] -> unit

Public Overridable Sub Write (buffer As Char())

參數

buffer

Char[]

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

例外狀況

ObjectDisposedException

TextWriter 已關閉。

IOException

發生 I/O 錯誤。

備註

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

這個預設方法會呼叫 Write(Char[], Int32, Int32) 方法，並傳遞整個字元陣列。 如果字元陣列是 null，則不會寫入任何內容。

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

另請參閱

• Write(Char[])
• 檔案和串流 I/O
• 如何：從檔案讀取文字
• 如何：將文字寫入檔案

Write(Char)

來源:

TextWriter.cs

將字元寫入文字數據流。

public:
 virtual void Write(char value);

public virtual void Write (char value);

abstract member Write : char -> unit
override this.Write : char -> unit

Public Overridable Sub Write (value As Char)

參數

value

Char

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

例外狀況

ObjectDisposedException

TextWriter 已關閉。

IOException

發生 I/O 錯誤。

備註

這個預設方法不會執行任何動作，但衍生類別可以覆寫 方法以提供適當的功能。

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

另請參閱

• Write(Char)
• Write(Char)
• 檔案和串流 I/O
• 如何：從檔案讀取文字
• 如何：將文字寫入檔案

Write(Boolean)

來源:

TextWriter.cs

將 Boolean 值的文字表示寫入文字數據流。

public:
 virtual void Write(bool value);

public virtual void Write (bool value);

abstract member Write : bool -> unit
override this.Write : bool -> unit

Public Overridable Sub Write (value As Boolean)

參數

value

Boolean

要寫入 Boolean 值。

例外狀況

ObjectDisposedException

TextWriter 已關閉。

IOException

發生 I/O 錯誤。

備註

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

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

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

另請參閱

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

Write(ReadOnlySpan<Char>)

來源:

TextWriter.cs

將字元範圍寫入文字數據流。

public:
 virtual void Write(ReadOnlySpan<char> buffer);

public virtual void Write (ReadOnlySpan<char> buffer);

abstract member Write : ReadOnlySpan<char> -> unit
override this.Write : ReadOnlySpan<char> -> unit

Public Overridable Sub Write (buffer As ReadOnlySpan(Of Char))

參數

buffer

ReadOnlySpan<Char>

要寫入的字元範圍。

備註

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

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