StringBuilder.Append Method (Char, Int32)

July 28, 2014

Appends a specified number of copies of the string representation of a Unicode character to the end of this instance.

Namespace:  System.Text
Assembly:  mscorlib (in mscorlib.dll)

public StringBuilder Append(
	char value,
	int repeatCount
)

Parameters

value
Type: System.Char
The character to append.
repeatCount
Type: System.Int32
The number of times to append value.

Return Value

Type: System.Text.StringBuilder
A reference to this instance after the append operation has completed.

ExceptionCondition
ArgumentOutOfRangeException

repeatCount is less than zero.

-or-

Enlarging the value of this instance would exceed its maximum capacity.

OutOfMemoryException

Out of memory.

The Append method modifies the existing instance of this class; it does not return a new class instance. Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object, as the following example illustrates.


decimal value = 1346.19m;
System.Text.StringBuilder sb = new System.Text.StringBuilder();
sb.Append('*', 5).AppendFormat("{0:C2}", value).Append('*', 5);
outputBlock.Text += sb + Environment.NewLine;
// The example displays the following output:
//       *****$1,346.19*****


The capacity of this instance is adjusted as needed.

Windows Phone OS

Supported in: 8.1, 8.0, 7.1, 7.0

Windows Phone

Show:
© 2014 Microsoft