设置容量和长度

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

[Visual Basic]Dim MyStringBuilder As New StringBuilder("Hello World!", 25)

 

[C#]StringBuilder MyStringBuilder = new StringBuilder("Hello World!", 25);

 

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

[Visual Basic]MyStringBuilder.Capacity = 25

 

[C#]MyStringBuilder.Capacity = 25;

 

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

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

修改 StringBuilder 字符串

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

方法名

使用


将信息追加到当前 StringBuilder 的结尾。


用带格式文本替换字符串中传递的格式说明符。


将字符串或对象插入到当前 StringBuilder 对象的指定索引处。


从当前 StringBuilder 对象中移除指定数量的字符。


替换指定索引处的指定字符。

Append

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

[Visual Basic]Dim MyStringBuilder As New StringBuilder("Hello World!")MyStringBuilder.Append(" What a beautiful day.")Console.WriteLine(MyStringBuilder)

 

[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 的结尾。

[Visual Basic]Dim MyInt As Integer = 25Dim MyStringBuilder As New StringBuilder("Your total is ")MyStringBuilder.AppendFormat("{0:C} ", MyInt)Console.WriteLine(MyStringBuilder)

 

[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 的第六个位置。

[Visual Basic]Dim MyStringBuilder As New StringBuilder("Hello World!")MyStringBuilder.Insert(6, "Beautiful ")Console.WriteLine(MyStringBuilder)

 

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

 

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

Remove

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

[Visual Basic]Dim MyStringBuilder As New StringBuilder("Hello World!")MyStringBuilder.Remove(5, 7)Console.WriteLine(MyStringBuilder)

 

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

 

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

Replace

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

[Visual Basic]Dim MyStringBuilder As New StringBuilder("Hello World!")MyStringBuilder.Replace("!"c, "?"c)Console.WriteLine(MyStringBuilder)

 

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

 

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