String 对象是不可改变的,StringBuilder 对象是动态对象,允许扩充它所封装的字符串中字符的数量,但是您可以为它可容纳的最大字符数指定一个值。
有两种种方法:(1)直接:StringBuilder MyStringBuilder = new StringBuilder("Hello World!", 25); (2)使用Capacity 属性来设置对象的最大长度:StringBuilder MyStringBuilder = new StringBuilder("Hello World!") MyStringBuilder.Capacity = 25;
EnsureCapacity 方法可用来检查当前 StringBuilder 的容量。如果容量大于传递的值,则不进行任何更改;但是,如果容量小于传递的值,则会更改当前的容量以使其与传递的值匹配。也可以查看或设置 Length 属性。如果将 Length 属性设置为大于 Capacity 属性的值,则自动将 Capacity 属性更改为与 Length 属性相同的值。如果将 Length 属性设置为小于当前 StringBuilder 对象内的字符串长度的值,则会缩短该字符串。
下表列出了可以用来修改 StringBuilder 的内容的方法。
方法名 | 使用 |
---|---|
StringBuilder.Append | 将信息追加到当前 StringBuilder 的结尾。 |
StringBuilder.AppendFormat | 用带格式文本替换字符串中传递的格式说明符。 |
StringBuilder.Insert | 将字符串或对象插入到当前 StringBuilder 对象的指定索引处。 |
StringBuilder.Remove | 从当前 StringBuilder 对象中移除指定数量的字符。 |
StringBuilder.Replace | 替换指定索引处的指定字符。 |
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 = 25 Dim 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); |