StringBuilder.Insert Method ( Int32, String, Int32 )

System.Text Namespace StringBuilder Class

Inserts one or more copies of a specified string into this instance at the specified character position.

[ VB ]
<Serializable>
Overloads Public Function Insert ( _
   ByVal index As Integer, _
   ByVal value As String, _
   ByVal count As Integer _
) As StringBuilder

[ C# ]
[Serializable]
public StringBuilder Insert ( 
   int index,
   string value,
   int count
);

[ C++ ]
[Serializable]
public: StringBuilder* Insert ( 
   int index,
   String* value,
   int count
);

[ JScript ]
public Serializable
function Insert ( 
   index : int,
   value : String,
   count : int
) : StringBuilder;

index: The position at which to insert.
value: The string to insert.
count: The number of times to insert value.

A reference to this instance after insertion has occurred.

Exception Type	Condition
ArgumentNullException	value is a null reference ( Nothing in Visual Basic ) and index and count are not zero.
ArgumentOutOfRangeException	index is less than zero or greater than the length of this instance. -or- count is less than one.

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

StringBuilder Members StringBuilder.Insert Overload List String

Check out related books at Amazon

StringBuilder.Insert Method ( Int32, String, Int32 )

Parameters

Return Value

Exceptions

Remarks

See Also