NGWS SDK Documentation  

This is preliminary documentation and subject to change.
To comment on this topic, please send us email at ngwssdk@microsoft.com. Thanks!

StringBuilder.Insert (Int32, Char[])

Inserts an array 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 _
) As StringBuilder
[C#]
public StringBuilder Insert(
   int index,
   char[] value
);
[C++]
public: StringBuilder* Insert(
   int index,
   __wchar_t* value[]
);
[JScript]
public function Insert(
   index : int,
   value : Char[]
) : StringBuilder;

Parameters

index
the position at which to insert.
value
the character array to be inserted.

Return Value

A reference to the current StringBuilder with value inserted at index.

Exceptions

Exception Type Condition
ArgumentOutOfRangeException if either index is greater than the length of the current StringBuilder, or index is less than zero.

Remarks

Existing characters are shifted to make room for the new text. The capacity is adjusted as needed.

If value is a null reference (in Visual Basic Nothing), the StringBuilder is not changed.

See Also

StringBuilder Class | StringBuilder Members | System.Text Namespace | StringBuilder.Insert Overload List