StringBuilder.Append Method (Char, Int32)
[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]
Appends a specified number of copies of the string representation of a Unicode character to the end of this instance.
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.StringBuilderA reference to this instance after the append operation has completed.
| Exception | Condition |
|---|---|
| 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.
The capacity of this instance is adjusted as needed.