使用StringBuilder类 - asp.net 教程

使用 StringBuilder 类

String对象是不可改变的。每次使用System.String类中的方法之一时，都要在内存中创建一个新的字符串对象，这就需要为该新对象分配新的空间。在需要对字符串执行重复修改的情况下，与创建新的String对象相关的系统开销可能会非常昂贵。如果要修改字符串而不创建新的对象，则可以使用System.Text.StringBuilder类。例如，当在一个循环中将许多字符串连接在一起时，使用StringBuilder类可以提升性能。

通过用一个重载的构造函数方法初始化变量，可以创建StringBuilder类的新实例，正如下面的示例中所阐释的那样。

C#

复制代码

StringBuilder MyStringBuilder = new StringBuilder("Hello World!");

设置容量和长度

虽然StringBuilder对象是动态对象，允许扩充它所封装的字符串中字符的数量，但是您可以为它可容纳的最大字符数指定一个值。此值称为该对象的容量，不应将它与当前StringBuilder对象容纳的字符串长度混淆在一起。例如，可以创建StringBuilder类的带有字符串“Hello”（长度为 5）的一个新实例，同时可以指定该对象的最大容量为 25。当修改StringBuilder时，在达到容量之前，它不会为其自己重新分配空间。当达到容量时，将自动分配新的空间且容量翻倍。可以使用重载的构造函数之一来指定StringBuilder类的容量。下面的示例指定可以将MyStringBuilder对象扩充到最大 25 个空白。

C#

复制代码

StringBuilder MyStringBuilder = new StringBuilder("Hello World!", 25);  

另外，可以使用读/写Capacity属性来设置对象的最大长度。下面的示例使用Capacity属性来定义对象的最大长度。

C#

复制代码

MyStringBuilder.Capacity = 25;

EnsureCapacity方法可用来检查当前StringBuilder的容量。如果容量大于传递的值，则不进行任何更改；但是，如果容量小于传递的值，则会更改当前的容量以使其与传递的值匹配。

也可以查看或设置Length属性。如果将Length属性设置为大于Capacity属性的值，则自动将Capacity属性更改为与Length属性相同的值。如果将Length属性设置为小于当前StringBuilder对象内的字符串长度的值，则会缩短该字符串。

修改 StringBuilder 字符串

下表列出了可以用来修改StringBuilder的内容的方法。

方法名使用

StringBuilder.Append	将信息追加到当前StringBuilder的结尾。
StringBuilder.AppendFormat	用带格式文本替换字符串中传递的格式说明符。
StringBuilder.Insert	将字符串或对象插入到当前StringBuilder对象的指定索引处。
StringBuilder.Remove	从当前StringBuilder对象中移除指定数量的字符。
StringBuilder.Replace	替换指定索引处的指定字符。

Append

Append方法可用来将文本或对象的字符串表示形式添加到由当前StringBuilder对象表示的字符串的结尾处。下面的示例将一个StringBuilder对象初始化为“Hello World”，然后将一些文本追加到该对象的结尾处。将根据需要自动分配空间。

C#

复制代码

StringBuilder MyStringBuilder = new StringBuilder("Hello World!");MyStringBuilder.Append(" What a beautiful day.");Console.WriteLine(MyStringBuilder);

此示例将Hello World! What a beautiful day.显示到控制台。

AppendFormat

AppendFormat方法将文本添加到StringBuilder的末尾，而且实现了IFormattable接口，因此可接受格式化部分中描述的标准格式字符串。可以使用此方法来自定义变量的格式并将这些值追加到StringBuilder的后面。下面的示例使用AppendFormat方法，将一个设置为货币值格式的整数值放到StringBuilder的末尾。

C#

复制代码

int MyInt = 25; StringBuilder MyStringBuilder = new StringBuilder("Your total is ");MyStringBuilder.AppendFormat("{0:C} ", MyInt);Console.WriteLine(MyStringBuilder);

此示例将Your total is $25.00显示到控制台。

Insert

Insert方法将字符串或对象添加到当前StringBuilder中的指定位置。下面的示例使用此方法将一个单词插入到StringBuilder的第六个位置。

C#

复制代码

StringBuilder MyStringBuilder = new StringBuilder("Hello World!");MyStringBuilder.Insert(6,"Beautiful ");Console.WriteLine(MyStringBuilder);

此示例将Hello Beautiful World!显示到控制台。

Remove

可以使用Remove方法从当前StringBuilder中移除指定数量的字符，移除过程从指定的从零开始的索引处开始。下面的示例使用Remove方法缩短StringBuilder。

C#

复制代码

StringBuilder MyStringBuilder = new StringBuilder("Hello World!");MyStringBuilder.Remove(5,7);Console.WriteLine(MyStringBuilder);

此示例将Hello显示到控制台。

Replace

使用Replace方法，可以用另一个指定的字符来替换StringBuilder对象内的字符。下面的示例使用Replace方法来搜索StringBuilder对象，查找所有的感叹号字符 (!)，并用问号字符 (?) 来替换它们。

C#

复制代码

StringBuilder MyStringBuilder = new StringBuilder("Hello World!");MyStringBuilder.Replace('!', '?');Console.WriteLine(MyStringBuilder);

此示例将Hello World?显示到控制台。

请参见

参考

System.Text.StringBuilder

其他资源

基本字符串操作