StringBuilder.Append Method (Char, Int32)
Microsoft Silverlight will reach end of support after October 2021. Learn more.
Updated: January 2011
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)
Syntax
'Declaration
Public Function Append ( _
value As Char, _
repeatCount As Integer _
) As StringBuilder
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.
Exceptions
| Exception | Condition |
|---|---|
| ArgumentOutOfRangeException | repeatCount is less than zero. -or- Enlarging the value of this instance would exceed its maximum capacity. |
| OutOfMemoryException | Out of memory. |
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 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() + vbCrLf
' The example displays the following output:
' *****$1,346.19*****
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.
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 |
|---|---|---|
January 2011 |
Expanded the Remarks section and removed the example. |
Customer feedback. |