StringBuilder.MaxCapacity Eigenschaft

Definition

Namespace:

System.Text

Assembly:

System.Runtime.dll

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

Int32

Die Höchstanzahl 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 Objekt in .NET Core und in der .NET Framework 4.0 und höher instanziieren, indem Sie den StringBuilderStringBuilder(Int32, Int32) Konstruktor aufrufen, kann sowohl die Länge als auch die Kapazität des StringBuilder instance über den Wert seiner MaxCapacity Eigenschaft hinausgehen. Dies kann insbesondere auftreten, wenn Sie die Append(String) Methoden und AppendFormat(String, Object) aufrufen, um kleine Zeichenfolgen anzufügen.