Inserts a subarray of unicode characters into the current StringBuilder at the specified position.
[Visual Basic] Overloads Public Function Insert( _ ByVal index As Integer, _ ByVal value() As Char, _ ByVal startIndex As Integer, _ ByVal charCount As Integer _ ) As StringBuilder [C#] public StringBuilder Insert( int index, char[] value, int startIndex, int charCount ); [C++] public: StringBuilder* Insert( int index, __wchar_t* value[], int startIndex, int charCount ); [JScript] public function Insert( index : int, value : Char[], startIndex : int, charCount : int ) : StringBuilder;
A reference to the current StringBuilder with value[startIndex..charCount) inserted at index.
Exception Type | Condition |
---|---|
ArgumentOutOfRangeException | if either index is greater than the length of the current StringBuilder, or index is less than zero. |
Existing characters are shifted to make room for the new text. The capacity is adjusted as needed.
If value equals Empty, the StringBuilder is not changed. Inserts the empty string if value is a null reference (in Visual Basic Nothing).
StringBuilder Class | StringBuilder Members | System.Text Namespace | StringBuilder.Insert Overload List