StringBuilder 类

表示可变字符字符串。无法继承此类。

有关此类型所有成员的列表，请参阅 StringBuilder 成员。

System.Object
System.Text.StringBuilder

[Visual Basic]
<Serializable>
NotInheritable Public Class StringBuilder
[C#]
[Serializable]
public sealed class StringBuilder
[C++]
[Serializable]
public __gc __sealed class StringBuilder
[JScript]
public
   Serializable
class StringBuilder

线程安全

此类型的所有公共静态（Visual Basic 中为 Shared）成员是线程安全的。但不保证任何实例成员是线程安全的。

备注

此类表示值为可变字符序列的类似字符串的对象。之所以说值是可变的，是因为在通过追加、移除、替换或插入字符而创建它后可以对它进行修改。有关比较，请参见 String 类。

大多数修改此类的实例的方法都返回对同一实例的引用。由于返回的是对实例的引用，因此可以调用该引用的方法或属性。如果想要编写将连续操作依次连接起来的单个语句，这将很方便。

StringBuilder 的容量是实例在任何给定时间可存储的最大字符数，并且大于或等于实例值的字符串表示形式的长度。容量可通过 Capacity 属性或 EnsureCapacity 方法来增加或减少，但它不能小于 Length 属性的值。

如果在初始化 StringBuilder 的实例时没有指定容量或最大容量，则使用特定于实现的默认值。

对实施者的说明: 此实现的默认容量是 16，默认的最大容量是 Int32.MaxValue。

当实例值增大时，StringBuilder 可按存储字符的需要分配更多的内存，同时对容量进行相应的调整。分配的内存量是特定于实现的，而且如果所需内存量大于最大容量，会引发 ArgumentOutOfRangeException。

例如，Append、AppendFormat、EnsureCapacity、Insert 和 Replace 方法能增大实例的值。

通过 Chars 属性可以访问 StringBuilder 的值中的单个字符。索引位置从零开始。

要求

命名空间: System.Text

平台: Windows 98, Windows NT 4.0, Windows ME, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 系列, .NET Framework 精简版

程序集: Mscorlib (在 Mscorlib.dll 中)