在 .NET Framework 中使用 StringBuilder 类

时间:2022-10-10 17:09:19

在 .NET Framework 中使用 StringBuilder 类

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

实例化 StringBuilder 对象
 

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

  StringBuilder MyStringBuilder = new StringBuilder("Hello World!");
 
 
设置容量和长度
 

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

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

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

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

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

AppendFormat


StringBuilder.AppendFormat 方法将文本添加到 StringBuilder 对象的结尾处。该方法通过调用要设置格式的对象的 IFormattable 实现来支持复合格式设置功能(有关更多信息,请参见复合格式设置)。因此,它接受数字、日期和时间以及枚举值的标准格式字符串、数字以及日期和时间值的自定义格式字符串,以及为自定义类型定义的格式字符串。(有关格式设置的信息,请参见.NET Framework 中的格式化类型。)可以使用此方法来自定义变量的格式并将这些值追加到 StringBuilder 的后面。下面的示例使用 AppendFormat 方法,将一个设置为货币值格式的整数值放到 StringBuilder 对象的末尾。

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

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

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

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

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

Replace


使用 Replace 方法可以用另一个指定的字符来替换 StringBuilder 对象内的字符。下面的示例使用 Replace 方法在 StringBuilder 对象中搜索感叹号字符 (!) 的所有实例,并将其替换为问号字符 (?)。

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

将 StringBuilder 对象转换为 String

 

必须先将 StringBuilder 对象转换为 String 对象,然后才能将 StringBuilder 对象表示的字符串传递给具有 String 参数的方法并在用户界面中显示它。可通过调用 StringBuilder.ToString 方法来执行此转换。下面的示例调用许多 StringBuilder 方法,然后调用 StringBuilder.ToString() 方法来显示字符串。

using System;
using System.Text; public class Example
{
public static void Main()
{
StringBuilder sb = new StringBuilder();
bool flag = true;
string[] spellings = { "recieve", "receeve", "receive" };
sb.AppendFormat("Which of the following spellings is {0}:", flag);
sb.AppendLine();
for (int ctr = ; ctr <= spellings.GetUpperBound(); ctr++) {
sb.AppendFormat(" {0}. {1}", ctr, spellings[ctr]);
sb.AppendLine();
}
sb.AppendLine();
Console.WriteLine(sb.ToString());
}
}

在 .NET Framework 中使用 StringBuilder 类