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

StringBuilder.Append メソッド (String, Int32, Int32)

2013/12/12

指定した部分文字列のコピーをこのインスタンスの末尾に追加します。

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

public StringBuilder Append(
	string value,
	int startIndex,
	int count
)

パラメーター

value
型: System.String
追加する部分文字列を含む String
startIndex
型: System.Int32
value における部分文字列の開始位置。
count
型: System.Int32
value 内の追加する文字数。

戻り値

型: System.Text.StringBuilder
追加操作が完了した後の、このインスタンスへの参照。

例外条件
ArgumentNullException

valuenull であり、startIndexcount が 0 以外の値です。

ArgumentOutOfRangeException

count が 0 未満です。

または

startIndex が 0 未満です。

または

startIndex + countvalue の長さを超えています。

または

このインスタンスの値を拡大すると、最大容量を超えます。

このメソッドは、value 内の指定した範囲の文字を現在のインスタンスに追加します。valuenull であり、startIndexcount がいずれも 0 の場合、変更は実行されません。

Append メソッドは、このクラスの既存のインスタンスを変更します。新しいクラス インスタンスは返しません。このため、次の例に示すように、既存の参照についてメソッドまたはプロパティを呼び出すことができ、戻り値を StringBuilder オブジェクトに割り当てる必要はありません。


string str = "First;George Washington;1789;1797";
int index = 0;
System.Text.StringBuilder sb = new System.Text.StringBuilder();
int length = str.IndexOf(';', index);      
sb.Append(str, index, length).Append(" President of the United States: ");
index += length + 1;
length = str.IndexOf(';', index) - index;
sb.Append(str, index, length).Append(", from ");
index += length + 1;
length = str.IndexOf(';', index) - index;
sb.Append(str, index, length).Append(" to ");
index += length + 1;
sb.Append(str, index, str.Length - index);
outputBlock.Text += sb + Environment.NewLine;
// The example displays the following output:
//    First President of the United States: George Washington, from 1789 to 1797      


このインスタンスの容量は、必要に応じて調整されます。

Windows Phone OS

サポート: 8.0, 7.1, 7.0

表示:
© 2014 Microsoft