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

StringBuilder::AppendFormat 方法 (String^, Object^)

 

向此实例追加通过处理复合格式字符串(包含零个或更多格式项)而返回的字符串。每个格式项都替换为一个参数的字符串表示形式。

命名空间:   System.Text
程序集:  mscorlib(mscorlib.dll 中)

public:
StringBuilder^ AppendFormat(
	String^ format,
	Object^ arg0
)

参数

format

复合格式字符串(请参见“备注”)。

arg0

要设置其格式的对象。

返回值

Type: System.Text::StringBuilder^

对追加了 format 的此实例的引用。 format 中的每个格式项都替换为 arg0 的字符串表示形式。

Exception Condition
ArgumentNullException

formatnull

FormatException

format 无效。

- 或 -

格式项的索引小于 0(零),或大于或等于 1。

ArgumentOutOfRangeException

扩展字符串的长度将超过 MaxCapacity

此方法使用若要将某个对象的值转换为其文本表示形式,并将该表示形式嵌入在当前的.NET frameworkStringBuilder对象。

format参数由零个或多个文本和零个或多个索引占位符称为格式项混和组成。格式项的索引必须为 0,对应于arg0,此方法的参数列表中的单个对象。格式设置过程会将每个格式项替换的字符串表示形式arg0

格式项的语法是,如下所示:

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

在方括号中的元素都是可选的。下表介绍每个元素。

元素

描述

Index — 索引

参数列表中要设置格式的对象的从零开始位置。如果指定的对象索引null,格式项替换为String::Empty如果在没有参数索引位置,FormatException引发。

,length

最小的字符串表示形式参数中的字符数。如果为正数,该参数是右对齐如果为负数,它是左对齐。

:格式字符串

一个由参数支持的标准或自定义格式字符串。

System_CAPS_note注意

有关使用日期和时间值的标准和自定义格式字符串,请参阅标准日期和时间格式字符串自定义日期和时间格式字符串有关与数值一起使用的标准和自定义格式字符串,请参阅标准数字格式字符串自定义数字格式字符串有关使用枚举的标准格式字符串,请参阅Wyliczanie ciągów formatujących

arg0表示要设置格式的对象。中的每个格式项format替换的字符串表示形式arg0如果格式项包含formatStringarg0实现IFormattable接口,则arg0.ToString(formatString, null)定义格式设置。否则为arg0.ToString()定义格式设置。

如果该字符串分配给format是"谢谢您捐赠 {0: # # #} 罐食品给我们的慈善组织。"和arg0是一个整数值为 10,返回的值将是"感谢您的 10 罐食品给我们的慈善组织您捐赠。"

对调用方的说明:

在.NET Framework 4和.NET Framework 4.5,当您实例化StringBuilder对象 (通过调用StringBuilder(Int32, Int32)构造函数的长度和容量的StringBuilder实例可以增长以超出的值及其MaxCapacity属性。发生这种情况尤其是当您调用AppendAppendFormat追加小型字符串的方法。

下面的示例演示AppendFormat方法。

using namespace System;
using namespace System::Text;
using namespace System::Globalization;
void Show( StringBuilder^ sbs )
{
   Console::WriteLine( sbs );
   sbs->Length = 0;
}

int main()
{
   StringBuilder^ sb = gcnew StringBuilder;
   int var1 = 111;
   float var2 = 2.22F;
   String^ var3 = "abcd";
   array<Object^>^var4 = {3,4.4,(Char)'X'};
   Console::WriteLine();
   Console::WriteLine( "StringBuilder.AppendFormat method:" );
   sb->AppendFormat( "1) {0}", var1 );
   Show( sb );
   sb->AppendFormat( "2) {0}, {1}", var1, var2 );
   Show( sb );
   sb->AppendFormat( "3) {0}, {1}, {2}", var1, var2, var3 );
   Show( sb );
   sb->AppendFormat( "4) {0}, {1}, {2}", var4 );
   Show( sb );
   CultureInfo^ ci = gcnew CultureInfo( "es-ES",true );
   array<Object^>^temp1 = {var2};
   sb->AppendFormat( ci, "5) {0}", temp1 );
   Show( sb );
}

/*
This example produces the following results:

StringBuilder.AppendFormat method:
1) 111
2) 111, 2.22
3) 111, 2.22, abcd
4) 3, 4.4, X
5) 2,22
*/

Universal Windows Platform
10 后可用
.NET Framework
1.1 后可用
返回页首
显示:
© 2016 Microsoft