StringBuilder.MaxCapacity プロパティ

定義

このインスタンスの最大容量を取得します。Gets the maximum capacity of this instance.

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

プロパティ値

このインスタンスが保持できる最大文字数。The maximum number of characters this instance can hold.

注釈

この実装の最大容量は Int32.MaxValueです。The maximum capacity for this implementation is Int32.MaxValue. ただし、この値は実装固有であり、その他の実装では異なる場合があります。However, this value is implementation-specific and might be different in other or later implementations. StringBuilder(Int32, Int32) コンストラクターを呼び出すことによって、StringBuilder オブジェクトの最大容量を明示的に設定できます。You can explicitly set the maximum capacity of a StringBuilder object by calling the StringBuilder(Int32, Int32) constructor.

.NET Core および .NET Framework 4.0 以降のバージョンでは、StringBuilder(Int32, Int32) コンストラクターを呼び出すことによって StringBuilder オブジェクトをインスタンス化すると、StringBuilder インスタンスの長さと容量の両方が、その MaxCapacity プロパティの値を超えて拡張される可能性があります。In .NET Core and in the .NET Framework 4.0 and later versions, when you instantiate the StringBuilder object by calling the StringBuilder(Int32, Int32) constructor, both the length and the capacity of the StringBuilder instance can grow beyond the value of its MaxCapacity property. これは、Append(String)AppendFormat(String, Object) メソッドを呼び出して小さい文字列を追加する場合に特に発生します。This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.

適用対象