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)

'Declaration
Public Function Append ( _
	value As Char, _
	repeatCount As Integer _
) As StringBuilder

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.


Dim value As Decimal = 1346.19d
Dim sb As New System.Text.StringBuilder()
sb.Append("*"c, 5).AppendFormat("{0:C2}", value).Append("*"c, 5)
outputBlock.Text += sb.ToString() + 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