Mono Class Library: System.Text.StringBuilder Overview | Members

System.Text.StringBuilder.Append Method

Appends the string representation of an array of Unicode characters to the end of the current instance.

public StringBuilder Append (char[] value, int startIndex, int charCount)

Parameters

value
The char array to be appended.
startIndex
A int containing the index in value at which the subarray starts.
charCount
A int containing the number of characters to copy from value .

Returns

The current instance after the operation has occurred.

Exceptions

TypeReason
ArgumentNullExceptionvalue is a null reference, and startIndex and charCount are not both zero.
ArgumentOutOfRangeException

charCount or startIndex is less than zero.

-or-

The sum of startIndex and charCount is greater than the length of value.

Remarks

This method appends the specified range of characters from the value array to the current instance. If value is a null reference, and both startIndex and charCount are zero, no changes are made.

The StringBuilder.Capacity of the current instance is increased as necessary.

Requirements

Namespace: System.Text
Assembly: mscorlib (in mscorlib.dll)
Assembly Versions: 1.0.5000.0, 2.0.0.0