TextWriter.Write 方法

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);

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)

參數

例外狀況

備註

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

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

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

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

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

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

參數 format 是由零或多個文字執行所組成，這些文字與零個或多個索引預留位置混合，稱為格式專案，對應至此方法參數清單中的物件。 格式化程式會將每個格式專案取代為對應物件值的字串表示。

格式專案的語法如下所示：

{index[，length][：formatString]}

在方括號中的元素是選擇性的元素。 下表說明每個元素。 如需複合格式功能的詳細資訊，包括格式專案的語法，請參閱 複合格式設定。

開頭和尾端大括弧字元 「{」 和 「}」 是必要的。 若要在 中 format 指定單一常值大括弧字元，請指定兩個前置或尾端大括弧字元;也就是 「{{」 或 「}}」。

這個方法不會在指定的字串中搜尋個別的新行字元 (十六進位的 0x000a)，也不會以 TextWriter.NewLine 取代它們。

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

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

另請參閱

• StreamWriter
• StringWriter
• IFormatProvider
• 檔案和資料流 I/O
• 作法：讀取檔案中的文字
• 作法：將文字寫入檔案

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)

參數

例外狀況

備註

這個方法會從位置 開始 index ， buffer 從字元陣列將資料字元寫入 count 這個 TextWriter 中。

此多載相當於 Write(Char[]) 與 ( + indexcount) 之間 index 每個字元 buffer 的多載。

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

另請參閱

• Write(Char[], Int32, Int32)
• Write(Char[], Int32, Int32)
• 檔案和資料流 I/O
• 作法：讀取檔案中的文字
• 作法：將文字寫入檔案

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

public virtual void Write (string format, params 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())

參數

例外狀況

備註

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

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

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

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

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

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

參數 format 是由零或多個文字執行所組成，這些文字與零個或多個索引預留位置混合，稱為格式專案，對應至此方法參數清單中的物件。 格式化程式會將每個格式專案取代為對應物件值的字串表示。

格式專案的語法如下所示：

{index[，length][：formatString]}

在方括號中的元素是選擇性的元素。 下表說明每個元素。 如需複合格式功能的詳細資訊，包括格式專案的語法，請參閱 複合格式設定。

開頭和尾端大括弧字元 「{」 和 「}」 是必要的。 若要在 中 format 指定單一常值大括弧字元，請指定兩個前置或尾端大括弧字元;也就是 「{{」 或 「}}」。

這個方法不會在指定的字串中搜尋個別的新行字元 (十六進位的 0x000a)，也不會以 TextWriter.NewLine 取代它們。

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

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

另請參閱

• StreamWriter
• StringWriter
• IFormatProvider
• 檔案和資料流 I/O
• 作法：讀取檔案中的文字
• 作法：將文字寫入檔案

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

public virtual void Write (string format, 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)

參數

例外狀況

備註

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

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

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

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

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

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

參數 format 是由零或多個文字執行所組成，這些文字與零個或多個索引預留位置混合，稱為格式專案，對應至此方法參數清單中的物件。 格式化程式會將每個格式專案取代為對應物件值的字串表示。

格式專案的語法如下所示：

{index[，length][：formatString]}

在方括號中的元素是選擇性的元素。 下表說明每個元素。 如需複合格式功能的詳細資訊，包括格式專案的語法，請參閱 複合格式設定。

開頭和尾端大括弧字元 「{」 和 「}」 是必要的。 若要在 中 format 指定單一常值大括弧字元，請指定兩個前置或尾端大括弧字元;也就是 「{{」 或 「}}」。

這個方法不會在指定的字串中搜尋個別的新行字元 (十六進位的 0x000a)，也不會以 TextWriter.NewLine 取代它們。

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

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

另請參閱

• StreamWriter
• StringWriter
• IFormatProvider
• 檔案和資料流 I/O
• 作法：讀取檔案中的文字
• 作法：將文字寫入檔案

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)

參數

屬性

CLSCompliantAttribute

例外狀況

備註

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

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

另請參閱

• StreamWriter
• StringWriter
• IFormatProvider
• 檔案和資料流 I/O
• 作法：讀取檔案中的文字
• 作法：將文字寫入檔案

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)

參數

屬性

CLSCompliantAttribute

例外狀況

備註

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

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

另請參閱

• StreamWriter
• StringWriter
• IFormatProvider
• 檔案和資料流 I/O
• 作法：讀取檔案中的文字
• 作法：將文字寫入檔案

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)

參數

備註

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

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

public virtual void Write (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)

參數

例外狀況

備註

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

這個方法不會在指定的字串中搜尋個別的新行字元 (十六進位的 0x000a)，也不會以 TextWriter.NewLine 取代它們。

如果 value 為 null，不寫入任何字串到文字資料流。

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

另請參閱

• Write(String)
• Write(String)
• 檔案和資料流 I/O
• 作法：讀取檔案中的文字
• 作法：將文字寫入檔案

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)

參數

例外狀況

備註

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

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

另請參閱

• StreamWriter
• StringWriter
• IFormatProvider
• 檔案和資料流 I/O
• 作法：讀取檔案中的文字
• 作法：將文字寫入檔案

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

public virtual void Write (string format, object arg0, 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)

參數

例外狀況

備註

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

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

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

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

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

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

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

格式專案的語法如下所示：

{index[，length][：formatString]}

在方括號中的元素是選擇性的元素。 下表說明每個元素。 如需複合格式功能的詳細資訊，包括格式專案的語法，請參閱 複合格式設定。

需要前置和尾端大括弧字元 「{」 和 「}」。 若要在 中 format 指定單一常值大括弧字元，請指定兩個前置或尾端大括弧字元;也就是 「{{」 或 「}}」。

這個方法不會在指定的字串中搜尋個別的新行字元 (十六進位的 0x000a)，也不會以 TextWriter.NewLine 取代它們。

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

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

另請參閱

• StreamWriter
• StringWriter
• IFormatProvider
• 檔案和資料流 I/O
• 作法：讀取檔案中的文字
• 作法：將文字寫入檔案

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

public virtual void Write (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)

參數

例外狀況

備註

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

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

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

另請參閱

• StreamWriter
• StringWriter
• IFormatProvider
• 檔案和資料流 I/O
• 作法：讀取檔案中的文字
• 作法：將文字寫入檔案

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)

參數

例外狀況

備註

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

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

作法：將文字寫入檔案

另請參閱

• StreamWriter
• StringWriter
• IFormatProvider

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)

參數

例外狀況

備註

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

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

另請參閱

• StreamWriter
• StringWriter
• IFormatProvider
• 檔案和資料流 I/O
• 作法：讀取檔案中的文字
• 作法：將文字寫入檔案

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)

參數

例外狀況

備註

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

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

另請參閱

• StreamWriter
• StringWriter
• IFormatProvider
• 檔案和資料流 I/O
• 作法：讀取檔案中的文字
• 作法：將文字寫入檔案

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)

參數

例外狀況

備註

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

另請參閱

• StreamWriter
• StringWriter
• IFormatProvider
• 檔案和資料流 I/O
• 作法：讀取檔案中的文字
• 作法：將文字寫入檔案

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

public virtual void Write (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())

參數

例外狀況

備註

這個方法不會在指定的字串中搜尋個別的新行字元 (十六進位的 0x000a)，也不會以 NewLine 取代它們。

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

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

另請參閱

• Write(Char[])
• 檔案和資料流 I/O
• 作法：讀取檔案中的文字
• 作法：將文字寫入檔案

public:
 abstract void Write(char value);

public:
 virtual void Write(char value);

public abstract void Write (char value);

public virtual void Write (char value);

abstract member Write : char -> unit

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

Public MustOverride Sub Write (value As Char)

Public Overridable Sub Write (value As Char)

參數

例外狀況

備註

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

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

另請參閱

• Write(Char)
• Write(Char)
• 檔案和資料流 I/O
• 作法：讀取檔案中的文字
• 作法：將文字寫入檔案

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)

參數

例外狀況

備註

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

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

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

另請參閱

• StreamWriter
• StringWriter
• 檔案和資料流 I/O
• 作法：讀取檔案中的文字
• 作法：將文字寫入檔案

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))

參數

備註

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

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