导出 (0) 打印
全部展开
此文章由机器翻译。 将光标移到文章的句子上,以查看原文。 更多信息。
译文
原文
此主题尚未评级 - 评价此主题

TextWriter.Write 方法 (String, Object, Object, Object)

使用与 String.Format(String, Object, Object, Object) 方法相同的语义将格式化字符串和新行写入文本字符串或流。

命名空间:  System.IO
程序集:  mscorlib(在 mscorlib.dll 中)
public virtual void Write(
	string format,
	Object arg0,
	Object arg1,
	Object arg2
)

参数

format
类型:System.String
复合格式字符串(请参见“备注”)。
arg0
类型:System.Object
要格式化和写入的第一个对象。
arg1
类型:System.Object
要格式化和写入的第二个对象。
arg2
类型:System.Object
要设置格式和写入的第三个对象。
异常条件
ArgumentNullException

formatnull

ObjectDisposedException

TextWriter 是关闭的。

IOException

发生 I/O 错误。

FormatException

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

- 或 -

格式项的索引小于 0 (0)、或大于或等于要设置格式的对象数 (用于该方法重载,为三)。

此方法使用 .NET Framework 的复合格式设置功能将对象的值转换为其字符串表示形式,并将该表示形式嵌入字符串中。 .NET Framework 提供了广泛的格式设置支持,下面的格式设置主题中对此有更详细的描述:

format 参数由零或多个文本序列与零或多个索引占位符混合组成,其中索引占位符称为格式项,对应于与此方法的参数列表中的对象。 格式设置过程将每个格式项替换为相应对象值的字符串表示形式。

格式项的语法如下:

{index[,length][:formatString]}

方括号中的元素是可选的。 下表描述每个元素。 有关复合格式设置功能(包括格式项的语法)的更多信息,请参见复合格式

元素

描述

Index — 索引

要设置格式的对象的参数列表中的位置(从零开始)。 如果由 index 指定的对象为 null,则格式项将被 String.Empty 替换。 由于此超加载具有三个对象在其参数列表,则的 索引 值必须始终为 0,1 或 2。 如果 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 系统要求.
本文是否对您有所帮助?
(1500 个剩余字符)
感谢您的反馈

社区附加资源

添加
显示:
© 2014 Microsoft. 版权所有。