エクスポート (0) 印刷
すべて展開
情報
要求されたトピックは次のとおりです。しかし、このトピックはこのライブラリには含まれていません。

StringBuilder コンストラクター (Int32, Int32)

2013/12/12

指定した容量で始まり、指定した最大容量まで大きくなる StringBuilder クラスの新しいインスタンスを初期化します。

Namespace:  System.Text
アセンブリ:  mscorlib (mscorlib.dll 内)

public StringBuilder(
	int capacity,
	int maxCapacity
)

パラメーター

capacity
型: System.Int32
StringBuilder の推奨される開始サイズ。
maxCapacity
型: System.Int32
現在の文字列が含むことができる最大文字数。

例外条件
ArgumentOutOfRangeException

maxCapacity が 1 未満で、capacity が 0 未満です。または capacitymaxCapacity を超えています。

capacity パラメーターは、現在のインスタンスによって割り当てられたメモリに格納できる最大文字数を定義します。その値は Capacity プロパティに代入されます。現在のインスタンスに格納される文字の数がこの capacity 値を超える場合、StringBuilder オブジェクトは、これらを格納するための追加のメモリを割り当てます。

capacity が 0 (ゼロ) の場合は、実装ごとに固有の既定容量が使用されます。

maxCapacity パラメーターは、現在のインスタンスが保持できる文字の最大数を定義します。現在のインスタンスに格納される文字の数がこの maxCapacity 値を超える場合、StringBuilder オブジェクトは追加のメモリを割り当てず、代わりに例外をスローします。

次のコード例は、容量と最大容量を指定して StringBuilder コンストラクターを呼び出す方法を示しています。


int capacity = 255;
int maxCapacity = 1024;
StringBuilder stringBuilder =
    new StringBuilder(capacity, maxCapacity);


Windows Phone OS

サポート: 8.0, 7.1, 7.0

表示:
© 2014 Microsoft