StringBuilder.Append Method (Char)
Microsoft Silverlight will reach end of support after October 2021. Learn more.
Appends the string representation of a specified Unicode character to the end of this instance.
Namespace: System.Text
Assembly: mscorlib (in mscorlib.dll)
Syntax
'Declaration
Public Function Append ( _
value As Char _
) As StringBuilder
public StringBuilder Append(
char value
)
Parameters
- value
Type: System.Char
The Unicode character to append.
Return Value
Type: System.Text.StringBuilder
A reference to this instance after the append operation has completed.
Exceptions
| Exception | Condition |
|---|---|
| ArgumentOutOfRangeException | Enlarging the value of this instance would exceed its maximum capacity. |
Remarks
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 str As String = "Characters in a string."
Dim sb As New System.Text.StringBuilder()
For Each ch In str
sb.Append(" '").Append(ch).Append("' ")
Next
outputBlock.Text += "Characters in the string:" + vbCrLf
outputBlock.Text += String.Format(" {0}", sb) + vbCrLf
' 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' '.'
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:\n";
outputBlock.Text += String.Format(" {0}\n", sb);
// 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.
Version Information
Silverlight
Supported in: 5, 4, 3
Silverlight for Windows Phone
Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0
XNA Framework
Supported in: Xbox 360, Windows Phone OS 7.0
Platforms
For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.
Change History
Date |
History |
Reason |
|---|---|---|
Expanded the Remarks section and removed the example. |
Customer feedback. |