本文為機器翻譯文章。如需檢視英文版,請選取 [原文] 核取方塊。您也可以將滑鼠指標移到文字上,即可在快顯視窗顯示英文原文。
譯文
原文

TextWriter.Write 方法 (String, Object)

 

使用與 String.Format(String, Object) 方法相同的語意,將格式化字串寫入到文字字串或資料流。

命名空間:   System.IO
組件:  mscorlib (於 mscorlib.dll)

public virtual void Write(
	string format,
	object arg0
)

參數

format
Type: System.String

複合格式字串 (請參閱<備註>)。

arg0
Type: System.Object

要格式化及寫入的物件。

Exception Condition
ArgumentNullException

formatnull

ObjectDisposedException

TextWriter 已關閉。

IOException

發生 I/O 錯誤。

FormatException

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

-或-

格式項目的索引小於 0 (零),或大於或等於 (這適用於這個方法多載,是一種) 要格式化的物件數目。

這個方法會使用.NET framework 物件的值轉換成其字串表示,以及該表示嵌入字串。 .NET Framework 提供廣泛的格式化支援,這會在下列格式的主題將詳細說明 ︰

format 參數是由零個或多個文字執行混合零或多個索引的預留位置,稱為對應格式項目,這個方法的參數清單中的物件。 格式化程序會將每個格式項目取代對應的物件值的字串表示。

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

{索引[,長度] [:formatString]}

方括號中的項目是選擇性的。 下表描述每個項目。 如需有關複合格式功能,包括語法的格式項目,請參閱 複合格式

項目

描述

索引

參數清單中要格式化之物件的以零為起始位置。 如果所指定的物件 索引null, ,格式項目取代為 String.Empty 因為這個多載其參數中的單一物件清單,值 索引 必須一律為 0。 如果在沒有參數 索引 位置 FormatException 就會擲回。

長度

參數的字串表示法中的字元數目下限。 如果是正數,參數是靠右對齊。如果是負數,它是靠左對齊。

:formatString

標準或自訂格式字串格式化的物件所支援。 可能值 formatString 物件所支援的值相同 ToString(format) 方法。 如果 formatString 未指定,並要格式化的物件會實作 IFormattable 介面, null 傳遞的值為 format 參數做為 IFormattable.ToString 格式字串。

前置和結尾大括號字元,"{"和"}",所需。 若要指定一個常值的大括號字元在 format, 、 指定兩個前置或結尾大括號字元; 也就是 「 {{"或"}} 」。

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

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

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

通用 Windows 平台
自 10 起供應
.NET Framework
自 1.1 起供應
Silverlight
自 2.0 起供應
Windows Phone Silverlight
自 7.0 起供應
回到頁首
顯示: