情報
要求されたトピックは次のとおりです。しかし、このトピックはこのライブラリには含まれていません。

StringBuilder.Append メソッド (Decimal)

2013/12/12

指定した 10 進数の文字列形式をこのインスタンスに追加します。

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

public StringBuilder Append(
	decimal value
)

パラメーター

value
型: System.Decimal
追加する値。

戻り値

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

例外条件
ArgumentOutOfRangeException

このインスタンスの値を増やすと、MaxCapacity を超えます。

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


decimal value = 1346.19m;
System.Text.StringBuilder sb = new System.Text.StringBuilder();
sb.Append('*', 5).Append(value).Append('*', 5);
outputBlock.Text += sb + Environment.NewLine;
// The example displays the following output:
//       *****1346.19*****


Append メソッドは、Decimal.ToString(IFormatProvider) メソッドを呼び出して、現在のカルチャの value の文字列形式を取得します。value の書式設定を制御するために、AppendFormat メソッドを呼び出します。

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

呼び出し時の注意

.NET Framework 4 および .NET Framework 4.5 では、StringBuilder コンストラクターを呼び出して StringBuilder オブジェクトをインスタンス化すると、StringBuilder インスタンスの長さと容量の両方が、その MaxCapacity プロパティの値を超える可能性があります。これが発生する可能性があるのは、特に、Append および AppendFormat メソッドを呼び出して短い文字列を追加するときです。

Windows Phone OS

サポート: 8.0

表示: