StringBuilder.MaxCapacity Eigenschaft

Definition

Ruft die maximale Kapazität dieser Instanz ab.

public:
 property int MaxCapacity { int get(); };
public int MaxCapacity { get; }
member this.MaxCapacity : int
Public ReadOnly Property MaxCapacity As Integer

Eigenschaftswert

Die maximale Anzahl von Zeichen, die diese Instanz enthalten kann.

Hinweise

Die maximale Kapazität für diese Implementierung ist Int32.MaxValue. Dieser Wert ist jedoch implementierungsspezifisch und kann sich in anderen oder späteren Implementierungen unterscheiden. Sie können die maximale Kapazität eines StringBuilder Objekts explizit festlegen, indem Sie den StringBuilder(Int32, Int32) Konstruktor aufrufen.

Wenn Sie das StringBuilder Objekt in .NET Core und in den .NET Framework 4.0- und höheren Versionen instanziieren, indem Sie den StringBuilder(Int32, Int32) Konstruktor aufrufen, kann sowohl die Länge als auch die Kapazität der StringBuilder Instanz über den Wert seiner MaxCapacity Eigenschaft hinaus wachsen. Dies kann insbesondere auftreten, wenn Sie die Append(String) Zeichenfolgen aufrufen und AppendFormat(String, Object) Methoden zum Anfügen kleiner Zeichenfolgen verwenden.

Gilt für: