本文由机器翻译。若要查看英语原文,请勾选“英语”复选框。 也可将鼠标指针移到文本上,在弹出窗口中显示英语原文。
翻译
英语

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 起可用
返回页首
显示: