StringBuilder.MaxCapacity 屬性

定義

命名空間:

System.Text

組件:

System.Runtime.dll

來源:

StringBuilder.cs

取得這個執行個體的最大容量。

public:
 property int MaxCapacity { int get(); };

public int MaxCapacity { get; }

member this.MaxCapacity : int

Public ReadOnly Property MaxCapacity As Integer

屬性值

Int32

這個執行個體可以容納的最大字元數。

備註

此實作的最大容量為 Int32.MaxValue 。 不過，此值是實作特有的，在其他或更新版本的實作中可能會不同。 您可以藉由呼叫 StringBuilder(Int32, Int32) 建構函式，明確地設定 物件的最大容量 StringBuilder 。

在 .NET Core 和 .NET Framework 4.0 和更新版本中，當您藉由呼叫 StringBuilder(Int32, Int32) 建構函式來具現化 StringBuilder 物件時，實例的 StringBuilder 長度和容量都可以成長超過其 MaxCapacity 屬性的值。 當您呼叫 Append(String) 和 AppendFormat(String, Object) 方法來附加小型字串時，就會發生此情況。