StringBuilder.Append Method (Char)
[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]
Appends the string representation of a specified Unicode character to the end of this instance.
Assembly: mscorlib (in mscorlib.dll)
Parameters
- value
- Type: System.Char
The Unicode character to append.
Return Value
Type: System.Text.StringBuilderA reference to this instance after the append operation has completed.
| Exception | Condition |
|---|---|
| ArgumentOutOfRangeException | Enlarging the value of this instance would exceed its maximum capacity. |
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.
string str = "Characters in a string."; System.Text.StringBuilder sb = new System.Text.StringBuilder(); foreach (var ch in str) sb.Append(" '").Append(ch).Append("' "); outputBlock.Text += "Characters in the string:" + Environment.NewLine; outputBlock.Text += String.Format(" {0}", sb) + Environment.NewLine; // The example displays the following output: // Characters in the string: // 'C' 'h' 'a' 'r' 'a' 'c' 't' 'e' 'r' 's' ' ' 'i' 'n' ' ' 'a' ' ' 's' 't' 'r' 'i' 'n' 'g' '.'
The capacity of this instance is adjusted as needed.