StringBuilder.MaxCapacity プロパティ


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

 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オブジェクトの最大容量は、 StringBuilder(Int32, Int32)コンストラクターを呼び出すことによって明示的に設定できます。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バージョンでは、 StringBuilder(Int32, Int32)コンストラクターを呼び出すことによってオブジェクトをインスタンス化するときに、 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.