匯出 (0) 列印
全部展開
本文章是由機器翻譯。 將指標移到文章內的文字上方即可查看原文。 其他資訊。
譯文
原文

TextWriter.Write 方法 (String, Object)

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

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

public virtual void Write(
	string format,
	Object arg0
)

參數

format
類型:System.String
複合格式字串 (請參閱<備註>)。
arg0
類型:System.Object
要格式化及寫入的物件。

例外狀況條件
ArgumentNullException

formatnull

ObjectDisposedException

TextWriter 已經關閉。

IOException

發生 I/O 錯誤。

FormatException

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

-或-

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

這個方法會使用 .NET Framework 的複合格式化功能,將物件的值轉換為其字串表示,並將該表示嵌入字串中。 .NET Framework 提供廣泛的格式化支援,這些在下列格式化主題中有極為詳盡的描述:

format 參數由零或多段文字組成,其中混合零或多個索引的預留位置 (稱為格式化項目),這些文字會對應於這個方法的參數清單中的物件。 格式化處理序會將每一個格式項目取代為對應物件值的字串表示。

格式項目的語法如下:

{index[,length][:formatString]}

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

元素

描述

Index - 索引

要進行格式化之物件的參數清單中,以零起始的位置。 如果 index 指定的物件為 null,則格式項目會以 String.Empty 取代。 因為這個多載的參數清單中只有一個單一物件,因此 index 的值必須永遠是 0。 如果 index 位置中沒有參數,則會擲回 FormatException

,length

參數之字串表示中的最小字元數。 若為正數,參數會靠右對齊;若為負數,則會靠左對齊。

:formatString

要進行格式化之物件所支援的標準或自訂格式字串。 formatString 的可能值與物件的 ToString(format) 方法所支援的值相同。 如果沒有指定 formatString,且要進行格式化的物件會實作 IFormattable 介面,則會傳遞 null,做為當成 IFormattable.ToString 格式字串使用的 format 參數值。

前後端的大括號字元 "{" 和 "}" 是必要的。 若要在 format 中指定單一常值的大括號字元,請指定兩個前置或後端大括號字元,亦即 "{{" 或 "}}"。

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

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

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

.NET Framework

支援版本:4.5、4、3.5、3.0、2.0、1.1、1.0

.NET Framework Client Profile

支援版本:4、3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (不支援伺服器核心角色), Windows Server 2008 R2 (SP1 (含) 以後版本支援伺服器核心角色,不支援 Itanium)

此.NET Framework 並不支援各種平台的所有版本。如需支援版本的清單,請參閱.NET Framework 系統需求.

社群新增項目

新增
顯示:
© 2015 Microsoft