StringBuilder.Append Method (Char, Int32)

Syntax

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

public StringBuilder Append(
    char value,
    int repeatCount
)

Exceptions

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.

See Also

Reference

Change History