使用 StringBuilder 类
String 对象是不可变的。 每次使用 System.String 类中的一个方法时，都要在内存中创建一个新的字符串对象，这就需要为该新对象分配新的空间。 在需要对字符串执行重复修改的情况下，与创建新的 String 对象相关的系统开销可能会非常大。 如果要修改字符串而不创建新的对象，则可以使用 System.Text.StringBuilder 类。 例如，当在一个循环中将许多字符串连接在一起时，使用 StringBuilder 类可以提升性能。
实例化 StringBuilder 对象
通过用一个重载的构造函数方法初始化变量可以创建 StringBuilder 类的新实例，如下面的示例中所阐释的那样。
Dim MyStringBuilder As New StringBuilder("Hello World!")
StringBuilder MyStringBuilder = new StringBuilder("Hello World!");
StringBuilder^ MyStringBuilder = gcnew StringBuilder("Hello World!");
设置容量和长度
虽然 StringBuilder 是动态对象，允许扩充它所封装的字符串中的字符数，但您可以通过一个值来指定该对象可容纳的最大字符数。 此值称为该对象的容量，不要将它与当前 StringBuilder 所容纳的字符串的长度相混淆。 例如，可以使用长度为 5 的字符串“Hello”创建 StringBuilder 类的一个新实例，同时可以指定该对象的最大容量为 25。 当修改 StringBuilder 时，在达到容量之前，该对象不会为自己重新分配空间。 当达到容量时，将自动分配新的空间且容量翻倍。 可以使用重载的构造函数之一来指定 StringBuilder 类的容量。 下面的示例指定可以将 MyStringBuilder 对象扩充到最大 25 个空白。
Dim MyStringBuilder As New StringBuilder("Hello World!", 25)
StringBuilder MyStringBuilder = new StringBuilder("Hello World!", 25);
StringBuilder^ MyStringBuilder = gcnew StringBuilder("Hello World!", 25);
另外，可以使用读/写 Capacity 属性来设置对象的最大长度。 下面的示例使用 Capacity 属性来定义对象的最大长度。
MyStringBuilder.Capacity = 25
MyStringBuilder.Capacity = 25;
MyStringBuilder->Capacity = 25;
EnsureCapacity 方法可用来检查当前 StringBuilder 的容量。 如果容量大于传递的值，则不进行任何更改；但是，如果容量小于传递的值，则会更改当前的容量以使其与传递的值匹配。
也可以查看或设置 Length 属性。 如果将 Length 属性设置为大于 Capacity 属性的值，则自动将 Capacity 属性更改为与 Length 属性相同的值。 如果将 Length 属性设置为小于当前 StringBuilder 对象内的字符串长度的值，则会缩短该字符串。
修改 StringBuilder 字符串
下表列出了可以用来修改 StringBuilder 的内容的方法。
方法名 |
使用 |
|---|---|
将信息追加到当前 StringBuilder 的结尾。 |
|
用带格式文本替换字符串中传递的格式说明符。 |
|
将字符串或对象插入到当前 StringBuilder 对象的指定索引处。 |
|
从当前 StringBuilder 对象中移除指定数量的字符。 |
|
替换指定索引处的指定字符。 |
Append
Append 方法可用来将文本或对象的字符串表示形式添加到由当前 StringBuilder 对象表示的字符串的结尾处。 下面的示例将一个 StringBuilder 对象初始化为“Hello World”，然后将一些文本追加到该对象的结尾处。 将根据需要自动分配空间。
Dim MyStringBuilder As New StringBuilder("Hello World!")
MyStringBuilder.Append(" What a beautiful day.")
Console.WriteLine(MyStringBuilder)
' The example displays the following output:
' Hello World! What a beautiful day.
StringBuilder MyStringBuilder = new StringBuilder("Hello World!");
MyStringBuilder.Append(" What a beautiful day.");
Console.WriteLine(MyStringBuilder);
// The example displays the following output:
// Hello World! What a beautiful day.
StringBuilder^ MyStringBuilder = gcnew StringBuilder("Hello World!");
MyStringBuilder->Append(" What a beautiful day.");
Console::WriteLine(MyStringBuilder);
// The example displays the following output:
// Hello World! What a beautiful day.
AppendFormat
StringBuilder.AppendFormat 方法将文本添加到 StringBuilder 对象的结尾处。 该方法通过调用要设置格式的对象的 IFormattable 实现来支持复合格式设置功能（有关更多信息，请参见复合格式）。 因此，它接受数字、日期和时间以及枚举值的标准格式字符串、数字以及日期和时间值的自定义格式字符串，以及为自定义类型定义的格式字符串。 （有关格式设置的信息，请参见格式化类型。）可以使用此方法来自定义变量的格式并将这些值追加到 StringBuilder 的后面。 下面的示例使用 AppendFormat 方法，将一个设置为货币值格式的整数值放到 StringBuilder 对象的末尾。
Dim MyInt As Integer = 25
Dim MyStringBuilder As New StringBuilder("Your total is ")
MyStringBuilder.AppendFormat("{0:C} ", MyInt)
Console.WriteLine(MyStringBuilder)
' The example displays the following output:
' Your total is $25.00
int MyInt = 25;
StringBuilder MyStringBuilder = new StringBuilder("Your total is ");
MyStringBuilder.AppendFormat("{0:C} ", MyInt);
Console.WriteLine(MyStringBuilder);
// The example displays the following output:
// Your total is $25.00
int MyInt = 25;
StringBuilder^ MyStringBuilder = gcnew StringBuilder("Your total is ");
MyStringBuilder->AppendFormat("{0:C} ", MyInt);
Console::WriteLine(MyStringBuilder);
// The example displays the following output:
// Your total is $25.00
Insert
Insert 方法将字符串或对象添加到当前 StringBuilder 对象中的指定位置。 下面的示例使用此方法将一个单词插入到 StringBuilder 对象的第六个位置。
Dim MyStringBuilder As New StringBuilder("Hello World!")
MyStringBuilder.Insert(6, "Beautiful ")
Console.WriteLine(MyStringBuilder)
' The example displays the following output:
' Hello Beautiful World!
StringBuilder MyStringBuilder = new StringBuilder("Hello World!");
MyStringBuilder.Insert(6,"Beautiful ");
Console.WriteLine(MyStringBuilder);
// The example displays the following output:
// Hello Beautiful World!
StringBuilder^ MyStringBuilder = gcnew StringBuilder("Hello World!");
MyStringBuilder->Insert(6,"Beautiful ");
Console::WriteLine(MyStringBuilder);
// The example displays the following output:
// Hello Beautiful World!
移除
可以使用 Remove 方法从当前 StringBuilder 对象中移除指定数量的字符，移除过程从指定的从零开始的索引处开始。 下面的示例使用 Remove 方法缩短 StringBuilder 对象。
Dim MyStringBuilder As New StringBuilder("Hello World!")
MyStringBuilder.Remove(5, 7)
Console.WriteLine(MyStringBuilder)
' The example displays the following output:
' Hello
StringBuilder MyStringBuilder = new StringBuilder("Hello World!");
MyStringBuilder.Remove(5,7);
Console.WriteLine(MyStringBuilder);
// The example displays the following output:
// Hello
StringBuilder^ MyStringBuilder = gcnew StringBuilder("Hello World!");
MyStringBuilder->Remove(5,7);
Console::WriteLine(MyStringBuilder);
// The example displays the following output:
// Hello
Replace
使用 Replace 方法可以用另一个指定的字符来替换 StringBuilder 对象内的字符。 下面的示例使用 Replace 方法在 StringBuilder 对象中搜索感叹号字符 (!) 的所有实例，并将其替换为问号字符 (?)。
Dim MyStringBuilder As New StringBuilder("Hello World!")
MyStringBuilder.Replace("!"c, "?"c)
Console.WriteLine(MyStringBuilder)
' The example displays the following output:
' Hello World?
StringBuilder MyStringBuilder = new StringBuilder("Hello World!");
MyStringBuilder.Replace('!', '?');
Console.WriteLine(MyStringBuilder);
// The example displays the following output:
// Hello World?
StringBuilder^ MyStringBuilder = gcnew StringBuilder("Hello World!");
MyStringBuilder->Replace('!', '?');
Console::WriteLine(MyStringBuilder);
// The example displays the following output:
// Hello World?
将 StringBuilder 对象转换为 String
必须先将 StringBuilder 对象转换为 String 对象，然后才能将 StringBuilder 对象表示的字符串传递给具有 String 参数的方法并在用户界面中显示它。 可通过调用 StringBuilder.ToString 方法来执行此转换。 下面的示例调用许多 StringBuilder 方法，然后调用 StringBuilder.ToString() 方法来显示字符串。
请参见
参考
概念
其他资源
修订记录
日期 |
修订记录 |
原因 |
|---|---|---|
添加了有关将 StringBuilder 转换为 String 的信息。 |
客户反馈 |