Insert Method (Int32, Char[], Int32, Int32)

[This documentation is for preview only, and is subject to change in later releases. Blank topics are included as placeholders.]

Inserts the string representation of a specified subarray of Unicode characters into this instance at the specified character position.

Namespace:  System.Text
Assembly:  mscorlib (in mscorlib.dll)

Syntax

'Declaration
Public Function Insert ( _
    index As Integer, _
    value As Char(), _
    startIndex As Integer, _
    charCount As Integer _
) As StringBuilder

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

public:
StringBuilder^ Insert(
    int index, 
    array<wchar_t>^ value, 
    int startIndex, 
    int charCount
)

member Insert : 
        index:int * 
        value:char[] * 
        startIndex:int * 
        charCount:int -> StringBuilder 

public function Insert(
    index : int, 
    value : char[], 
    startIndex : int, 
    charCount : int
) : StringBuilder

Parameters

• index
  Type: System. . :: . .Int32
  The position in this instance where insertion begins.

• value
  Type: array<System. . :: . .Char> [] () [] []
  A character array.

• startIndex
  Type: System. . :: . .Int32
  The starting index within value.

• charCount
  Type: System. . :: . .Int32
  The number of characters to insert.

Return Value

Type: System.Text. . :: . .StringBuilder
A reference to this instance after the insert operation has completed.

Remarks

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

.NET Framework Security

• Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see dd66cd4c-b087-415f-9c3e-94e3a1835f74.

See Also

Reference

StringBuilder Class

Insert Overload

System.Text Namespace