Inserts the string representation of a specified object into this instance at a specified character position.
Overloads Insert(Int32, SByte)Inserts the string representation of a specified 8-bit signed integer into this instance at the specified character position.
Insert(Int32, Char[], Int32, Int32)Inserts the string representation of a specified subarray of Unicode characters into this instance at the specified character position.
Insert(Int32, String, Int32)Inserts one or more copies of a specified string into this instance at the specified character position.
Insert(Int32, UInt64)Inserts the string representation of a 64-bit unsigned integer into this instance at the specified character position.
Insert(Int32, UInt32)Inserts the string representation of a 32-bit unsigned integer into this instance at the specified character position.
Insert(Int32, UInt16)Inserts the string representation of a 16-bit unsigned integer into this instance at the specified character position.
Insert(Int32, String)Inserts a string into this instance at the specified character position.
Insert(Int32, Single)Inserts the string representation of a single-precision floating point number into this instance at the specified character position.
Insert(Int32, ReadOnlySpan<Char>)Inserts the sequence of characters into this instance at the specified character position.
Insert(Int32, Int16)Inserts the string representation of a specified 16-bit signed integer into this instance at the specified character position.
Insert(Int32, Int64)Inserts the string representation of a 64-bit signed integer into this instance at the specified character position.
Insert(Int32, Int32)Inserts the string representation of a specified 32-bit signed integer into this instance at the specified character position.
Insert(Int32, Object)Inserts the string representation of an object into this instance at the specified character position.
Insert(Int32, Double)Inserts the string representation of a double-precision floating-point number into this instance at the specified character position.
Insert(Int32, Decimal)Inserts the string representation of a decimal number into this instance at the specified character position.
Insert(Int32, Char[])Inserts the string representation of a specified array of Unicode characters into this instance at the specified character position.
Insert(Int32, Char)Inserts the string representation of a specified Unicode character into this instance at the specified character position.
Insert(Int32, Byte)Inserts the string representation of a specified 8-bit unsigned integer into this instance at the specified character position.
Insert(Int32, Boolean)Inserts the string representation of a Boolean value into this instance at the specified character position.
ExamplesThe following example demonstrates the Insert method.
using System;
using System.Text;
class Sample
{
// index: 012345
static string initialValue = "--[]--";
static StringBuilder sb;
public static void Main()
{
string xyz = "xyz";
char[] abc = {'a', 'b', 'c'};
char star = '*';
Object obj = 0;
bool xBool = true;
byte xByte = 1;
short xInt16 = 2;
int xInt32 = 3;
long xInt64 = 4;
Decimal xDecimal = 5;
float xSingle = 6.6F;
double xDouble = 7.7;
// The following types are not CLS-compliant.
ushort xUInt16 = 8;
uint xUInt32 = 9;
ulong xUInt64 = 10;
sbyte xSByte = -11;
//
Console.WriteLine("StringBuilder.Insert method");
sb = new StringBuilder(initialValue);
sb.Insert(3, xyz, 2);
Show(1, sb);
sb.Insert(3, xyz);
Show(2, sb);
sb.Insert(3, star);
Show(3, sb);
sb.Insert(3, abc);
Show(4, sb);
sb.Insert(3, abc, 1, 2);
Show(5, sb);
sb.Insert(3, xBool); // True
Show(6, sb);
sb.Insert(3, obj); // 0
Show(7, sb);
sb.Insert(3, xByte); // 1
Show(8, sb);
sb.Insert(3, xInt16); // 2
Show(9, sb);
sb.Insert(3, xInt32); // 3
Show(10, sb);
sb.Insert(3, xInt64); // 4
Show(11, sb);
sb.Insert(3, xDecimal); // 5
Show(12, sb);
sb.Insert(3, xSingle); // 6.6
Show(13, sb);
sb.Insert(3, xDouble); // 7.7
Show(14, sb);
// The following Insert methods are not CLS-compliant.
sb.Insert(3, xUInt16); // 8
Show(15, sb);
sb.Insert(3, xUInt32); // 9
Show(16, sb);
sb.Insert(3, xUInt64); // 10
Show(17, sb);
sb.Insert(3, xSByte); // -11
Show(18, sb);
//
}
public static void Show(int overloadNumber, StringBuilder sbs)
{
Console.WriteLine("{0,2:G} = {1}", overloadNumber, sbs.ToString());
sb = new StringBuilder(initialValue);
}
}
/*
This example produces the following results:
StringBuilder.Insert method
1 = --[xyzxyz]--
2 = --[xyz]--
3 = --[*]--
4 = --[abc]--
5 = --[bc]--
6 = --[True]--
7 = --[0]--
8 = --[1]--
9 = --[2]--
10 = --[3]--
11 = --[4]--
12 = --[5]--
13 = --[6.6]--
14 = --[7.7]--
15 = --[8]--
16 = --[9]--
17 = --[10]--
18 = --[-11]--
*/
open System.Text
let initialValue = "--[]--"
let show overloadNumber (sbs: StringBuilder) =
printfn $"{overloadNumber, 2:G} = {sbs}"
sbs.Clear().Append initialValue |> ignore
let xyz = "xyz"
let abc = [| 'a'; 'b'; 'c' |]
let star = '*'
let obj: obj = 0
let xBool = true
let xByte = 1uy
let xInt16 = 2s
let xInt32 = 3
let xInt64 = 4L
let xDecimal = 5M
let xSingle = 6.6f
let xDouble = 7.7
// The following types are not CLS-compliant.
let xUInt16 = 8us
let xUInt32 = 9u
let xUInt64 = 10uL
let xSByte = -11y
printfn "StringBuilder.Insert method"
let sb = StringBuilder initialValue
sb.Insert(3, xyz, 2) |> ignore
show 1 sb
sb.Insert(3, xyz) |> ignore
show 2 sb
sb.Insert(3, star) |> ignore
show 3 sb
sb.Insert(3, abc) |> ignore
show 4 sb
sb.Insert(3, abc, 1, 2) |> ignore
show 5 sb
sb.Insert(3, xBool) |> ignore // True
show 6 sb
sb.Insert(3, obj) |> ignore // 0
show 7 sb
sb.Insert(3, xByte) |> ignore // 1
show 8 sb
sb.Insert(3, xInt16) |> ignore // 2
show 9 sb
sb.Insert(3, xInt32) |> ignore // 3
show 10 sb
sb.Insert(3, xInt64) |> ignore // 4
show 11 sb
sb.Insert(3, xDecimal) |> ignore // 5
show 12 sb
sb.Insert(3, xSingle) |> ignore // 6.6
show 13 sb
sb.Insert(3, xDouble) |> ignore // 7.7
show 14 sb
// The following Insert methods are not CLS-compliant.
sb.Insert(3, xUInt16) |> ignore // 8
show 15 sb
sb.Insert(3, xUInt32) |> ignore // 9
show 16 sb
sb.Insert(3, xUInt64) |> ignore // 10
show 17 sb
sb.Insert(3, xSByte) |> ignore // -11
show 18 sb
// This example produces the following results:
// StringBuilder.Insert method
// 1 = --[xyzxyz]--
// 2 = --[xyz]--
// 3 = --[*]--
// 4 = --[abc]--
// 5 = --[bc]--
// 6 = --[True]--
// 7 = --[0]--
// 8 = --[1]--
// 9 = --[2]--
// 10 = --[3]--
// 11 = --[4]--
// 12 = --[5]--
// 13 = --[6.6]--
// 14 = --[7.7]--
// 15 = --[8]--
// 16 = --[9]--
// 17 = --[10]--
// 18 = --[-11]--
Imports System.Text
Class Sample
' index: 012345
Private Shared initialValue As String = "--[]--"
Private Shared sb As StringBuilder
Public Shared Sub Main()
Dim xyz As String = "xyz"
Dim abc As Char() = {"a"c, "b"c, "c"c}
Dim star As Char = "*"c
Dim obj As [Object] = 0
Dim xBool As Boolean = True
Dim xByte As Byte = 1
Dim xInt16 As Short = 2
Dim xInt32 As Integer = 3
Dim xInt64 As Long = 4
Dim xDecimal As [Decimal] = 5
Dim xSingle As Single = 6.6F
Dim xDouble As Double = 7.7
' The following types are not CLS-compliant.
' Dim xUInt16 As System.UInt16 = 8
' Dim xUInt32 As System.UInt32 = 9
' Dim xUInt64 As System.UInt64 = 10
' Dim xSByte As System.SByte = - 11
'
Console.WriteLine("StringBuilder.Insert method")
sb = New StringBuilder(initialValue)
sb.Insert(3, xyz, 2)
Show(1, sb)
sb.Insert(3, xyz)
Show(2, sb)
sb.Insert(3, star)
Show(3, sb)
sb.Insert(3, abc)
Show(4, sb)
sb.Insert(3, abc, 1, 2)
Show(5, sb)
sb.Insert(3, xBool) ' True
Show(6, sb)
sb.Insert(3, obj) ' 0
Show(7, sb)
sb.Insert(3, xByte) ' 1
Show(8, sb)
sb.Insert(3, xInt16) ' 2
Show(9, sb)
sb.Insert(3, xInt32) ' 3
Show(10, sb)
sb.Insert(3, xInt64) ' 4
Show(11, sb)
sb.Insert(3, xDecimal) ' 5
Show(12, sb)
sb.Insert(3, xSingle) ' 6.6
Show(13, sb)
sb.Insert(3, xDouble) ' 7.7
Show(14, sb)
' The following Insert methods are not CLS-compliant.
' sb.Insert(3, xUInt16) ' 8
' sb.Insert(3, xUInt32) ' 9
' sb.Insert(3, xUInt64) ' 10
' sb.Insert(3, xSByte) ' -11
End Sub
Public Shared Sub Show(overloadNumber As Integer, sbs As StringBuilder)
Console.WriteLine("{0,2:G} = {1}", overloadNumber, sbs.ToString())
sb = New StringBuilder(initialValue)
End Sub
End Class
'
'This example produces the following results:
'
'StringBuilder.Insert method
' 1 = --[xyzxyz]--
' 2 = --[xyz]--
' 3 = --[*]--
' 4 = --[abc]--
' 5 = --[bc]--
' 6 = --[True]--
' 7 = --[0]--
' 8 = --[1]--
' 9 = --[2]--
'10 = --[3]--
'11 = --[4]--
'12 = --[5]--
'13 = --[6.6]--
'14 = --[7.7]--
'
Insert(Int32, SByte)
Important
This API is not CLS-compliant.
Inserts the string representation of a specified 8-bit signed integer into this instance at the specified character position.
public:
System::Text::StringBuilder ^ Insert(int index, System::SByte value);
[System.CLSCompliant(false)]
public System.Text.StringBuilder Insert(int index, sbyte value);
[<System.CLSCompliant(false)>]
member this.Insert : int * sbyte -> System.Text.StringBuilder
Public Function Insert (index As Integer, value As SByte) As StringBuilder
Parameters
The position in this instance where insertion begins.
The value to insert.
ReturnsA reference to this instance after the insert operation has completed.
index
is less than zero or greater than the length of this instance.
Enlarging the value of this instance would exceed MaxCapacity.
RemarksSByte.ToString is used to get a string representation of value
. Existing characters are shifted to make room for the new text. The capacity is adjusted as needed.
In the .NET Framework 3.5 Service Pack 1 and earlier versions, calls to this method threw an ArgumentOutOfRangeException if inserting value
would cause the object's total length to exceed MaxCapacity. Starting with the .NET Framework 4, the method throws an OutOfMemoryException.
Inserts the string representation of a specified subarray of Unicode characters into this instance at the specified character position.
public:
System::Text::StringBuilder ^ Insert(int index, cli::array <char> ^ value, int startIndex, int charCount);
public System.Text.StringBuilder Insert(int index, char[] value, int startIndex, int charCount);
public System.Text.StringBuilder Insert(int index, char[]? value, int startIndex, int charCount);
member this.Insert : int * char[] * int * int -> System.Text.StringBuilder
Public Function Insert (index As Integer, value As Char(), startIndex As Integer, charCount As Integer) As StringBuilder
Parameters
The position in this instance where insertion begins.
A character array.
The starting index within value
.
The number of characters to insert.
ReturnsA reference to this instance after the insert operation has completed.
Exceptionsvalue
is null
, and startIndex
and charCount
are not zero.
index
, startIndex
, or charCount
is less than zero.
-or-
index
is greater than the length of this instance.
-or-
startIndex
plus charCount
is not a position within value
.
-or-
Enlarging the value of this instance would exceed MaxCapacity.
RemarksExisting characters are shifted to make room for the new text. The capacity of this instance is adjusted as needed.
Insert(Int32, String, Int32)Inserts one or more copies of a specified string into this instance at the specified character position.
public:
System::Text::StringBuilder ^ Insert(int index, System::String ^ value, int count);
public System.Text.StringBuilder Insert(int index, string value, int count);
public System.Text.StringBuilder Insert(int index, string? value, int count);
member this.Insert : int * string * int -> System.Text.StringBuilder
Public Function Insert (index As Integer, value As String, count As Integer) As StringBuilder
Parameters
The position in this instance where insertion begins.
The string to insert.
The number of times to insert value
.
A reference to this instance after insertion has completed.
Exceptionsindex
is less than zero or greater than the current length of this instance.
-or-
count
is less than zero.
Existing characters are shifted to make room for the new text. The capacity of this instance is adjusted as needed.
This StringBuilder object is not changed if value
is null
, value
is not null
but its length is zero, or count
is zero.
Important
This API is not CLS-compliant.
Inserts the string representation of a 64-bit unsigned integer into this instance at the specified character position.
public:
System::Text::StringBuilder ^ Insert(int index, System::UInt64 value);
[System.CLSCompliant(false)]
public System.Text.StringBuilder Insert(int index, ulong value);
[<System.CLSCompliant(false)>]
member this.Insert : int * uint64 -> System.Text.StringBuilder
Public Function Insert (index As Integer, value As ULong) As StringBuilder
Parameters
The position in this instance where insertion begins.
The value to insert.
ReturnsA reference to this instance after the insert operation has completed.
index
is less than zero or greater than the length of this instance.
Enlarging the value of this instance would exceed MaxCapacity.
RemarksUInt64.ToString is used to get a string representation of value
. Existing characters are shifted to make room for the new text. The capacity of this instance is adjusted as needed.
In the .NET Framework 3.5 Service Pack 1 and earlier versions, calls to this method threw an ArgumentOutOfRangeException if inserting value
would cause the object's total length to exceed MaxCapacity. Starting with the .NET Framework 4, the method throws an OutOfMemoryException.
Important
This API is not CLS-compliant.
Inserts the string representation of a 32-bit unsigned integer into this instance at the specified character position.
public:
System::Text::StringBuilder ^ Insert(int index, System::UInt32 value);
[System.CLSCompliant(false)]
public System.Text.StringBuilder Insert(int index, uint value);
[<System.CLSCompliant(false)>]
member this.Insert : int * uint32 -> System.Text.StringBuilder
Public Function Insert (index As Integer, value As UInteger) As StringBuilder
Parameters
The position in this instance where insertion begins.
The value to insert.
ReturnsA reference to this instance after the insert operation has completed.
index
is less than zero or greater than the length of this instance.
Enlarging the value of this instance would exceed MaxCapacity.
RemarksUInt32.ToString is used to get a string representation of value
. Existing characters are shifted to make room for the new text. The capacity of this instance is adjusted as needed.
In the .NET Framework 3.5 Service Pack 1 and earlier versions, calls to this method threw an ArgumentOutOfRangeException if inserting value
would cause the object's total length to exceed MaxCapacity. Starting with the .NET Framework 4, the method throws an OutOfMemoryException.
Important
This API is not CLS-compliant.
Inserts the string representation of a 16-bit unsigned integer into this instance at the specified character position.
public:
System::Text::StringBuilder ^ Insert(int index, System::UInt16 value);
[System.CLSCompliant(false)]
public System.Text.StringBuilder Insert(int index, ushort value);
[<System.CLSCompliant(false)>]
member this.Insert : int * uint16 -> System.Text.StringBuilder
Public Function Insert (index As Integer, value As UShort) As StringBuilder
Parameters
The position in this instance where insertion begins.
The value to insert.
ReturnsA reference to this instance after the insert operation has completed.
index
is less than zero or greater than the length of this instance.
Enlarging the value of this instance would exceed MaxCapacity.
RemarksUInt16.ToString is used to get a string representation of value
. Existing characters are shifted to make room for the new text. The capacity of this instance is adjusted as needed.
In the .NET Framework 3.5 Service Pack 1 and earlier versions, calls to this method threw an ArgumentOutOfRangeException if inserting value
would cause the object's total length to exceed MaxCapacity. Starting with the .NET Framework 4, the method throws an OutOfMemoryException.
Inserts a string into this instance at the specified character position.
public:
System::Text::StringBuilder ^ Insert(int index, System::String ^ value);
public System.Text.StringBuilder Insert(int index, string value);
public System.Text.StringBuilder Insert(int index, string? value);
member this.Insert : int * string -> System.Text.StringBuilder
Public Function Insert (index As Integer, value As String) As StringBuilder
Parameters
The position in this instance where insertion begins.
The string to insert.
ReturnsA reference to this instance after the insert operation has completed.
Exceptionsindex
is less than zero or greater than the current length of this instance.
-or-
The current length of this StringBuilder object plus the length of value
exceeds MaxCapacity.
Existing characters are shifted to make room for the new text. The capacity is adjusted as needed.
This instance of StringBuilder is not changed if value
is null
, or value
is not null
but its length is zero.
Inserts the string representation of a single-precision floating point number into this instance at the specified character position.
public:
System::Text::StringBuilder ^ Insert(int index, float value);
public System.Text.StringBuilder Insert(int index, float value);
member this.Insert : int * single -> System.Text.StringBuilder
Public Function Insert (index As Integer, value As Single) As StringBuilder
Parameters
The position in this instance where insertion begins.
The value to insert.
ReturnsA reference to this instance after the insert operation has completed.
Exceptionsindex
is less than zero or greater than the length of this instance.
Enlarging the value of this instance would exceed MaxCapacity.
RemarksSingle.ToString is used to get a string representation of value
. Existing characters are shifted to make room for the new text. The capacity of this instance is adjusted as needed.
In the .NET Framework 3.5 Service Pack 1 and earlier versions, calls to this method threw an ArgumentOutOfRangeException if inserting value
would cause the object's total length to exceed MaxCapacity. Starting with the .NET Framework 4, the method throws an OutOfMemoryException.
Inserts the sequence of characters into this instance at the specified character position.
public:
System::Text::StringBuilder ^ Insert(int index, ReadOnlySpan<char> value);
public System.Text.StringBuilder Insert(int index, ReadOnlySpan<char> value);
member this.Insert : int * ReadOnlySpan<char> -> System.Text.StringBuilder
Public Function Insert (index As Integer, value As ReadOnlySpan(Of Char)) As StringBuilder
Parameters
The position in this instance where insertion begins.
ReturnsA reference to this instance after the insert operation has completed.
RemarksThe existing characters are shifted to make room for the character sequence in the value
to insert it. The capacity is adjusted as needed.
Inserts the string representation of a specified 16-bit signed integer into this instance at the specified character position.
public:
System::Text::StringBuilder ^ Insert(int index, short value);
public System.Text.StringBuilder Insert(int index, short value);
member this.Insert : int * int16 -> System.Text.StringBuilder
Public Function Insert (index As Integer, value As Short) As StringBuilder
Parameters
The position in this instance where insertion begins.
The value to insert.
ReturnsA reference to this instance after the insert operation has completed.
Exceptionsindex
is less than zero or greater than the length of this instance.
Enlarging the value of this instance would exceed MaxCapacity.
RemarksInt16.ToString is used to get a string representation of value
. Existing characters are shifted to make room for the new text. The capacity of this instance is adjusted as needed.
In the .NET Framework 3.5 Service Pack 1 and earlier versions, calls to this method threw an ArgumentOutOfRangeException if inserting value
would cause the object's total length to exceed MaxCapacity. Starting with the .NET Framework 4, the method throws an OutOfMemoryException.
Inserts the string representation of a 64-bit signed integer into this instance at the specified character position.
public:
System::Text::StringBuilder ^ Insert(int index, long value);
public System.Text.StringBuilder Insert(int index, long value);
member this.Insert : int * int64 -> System.Text.StringBuilder
Public Function Insert (index As Integer, value As Long) As StringBuilder
Parameters
The position in this instance where insertion begins.
The value to insert.
ReturnsA reference to this instance after the insert operation has completed.
Exceptionsindex
is less than zero or greater than the length of this instance.
Enlarging the value of this instance would exceed MaxCapacity.
RemarksInt64.ToString is used to get a string representation of value
. Existing characters are shifted to make room for the new text. The capacity of this instance is adjusted as needed.
In the .NET Framework 3.5 Service Pack 1 and earlier versions, calls to this method threw an ArgumentOutOfRangeException if inserting value
would cause the object's total length to exceed MaxCapacity. Starting with the .NET Framework 4, the method throws an OutOfMemoryException.
Inserts the string representation of a specified 32-bit signed integer into this instance at the specified character position.
public:
System::Text::StringBuilder ^ Insert(int index, int value);
public System.Text.StringBuilder Insert(int index, int value);
member this.Insert : int * int -> System.Text.StringBuilder
Public Function Insert (index As Integer, value As Integer) As StringBuilder
Parameters
The position in this instance where insertion begins.
The value to insert.
ReturnsA reference to this instance after the insert operation has completed.
Exceptionsindex
is less than zero or greater than the length of this instance.
Enlarging the value of this instance would exceed MaxCapacity.
RemarksInt32.ToString is used to get a string representation of value
. Existing characters are shifted to make room for the new text. The capacity of this instance is adjusted as needed.
In the .NET Framework 3.5 Service Pack 1 and earlier versions, calls to this method threw an ArgumentOutOfRangeException if inserting value
would cause the object's total length to exceed MaxCapacity. Starting with the .NET Framework 4, the method throws an OutOfMemoryException.
Inserts the string representation of an object into this instance at the specified character position.
public:
System::Text::StringBuilder ^ Insert(int index, System::Object ^ value);
public System.Text.StringBuilder Insert(int index, object value);
public System.Text.StringBuilder Insert(int index, object? value);
member this.Insert : int * obj -> System.Text.StringBuilder
Public Function Insert (index As Integer, value As Object) As StringBuilder
Parameters
The position in this instance where insertion begins.
The object to insert, or null
.
A reference to this instance after the insert operation has completed.
Exceptionsindex
is less than zero or greater than the length of this instance.
Enlarging the value of this instance would exceed MaxCapacity.
RemarksObject.ToString is used to get a string representation of value
. Existing characters are shifted to make room for the new text. The capacity of this instance is adjusted as needed.
If value
is null
, the value of this instance is unchanged.
In the .NET Framework 3.5 Service Pack 1 and earlier versions, calls to this method threw an ArgumentOutOfRangeException if inserting value
would cause the object's total length to exceed MaxCapacity. Starting with the .NET Framework 4, the method throws an OutOfMemoryException.
Inserts the string representation of a double-precision floating-point number into this instance at the specified character position.
public:
System::Text::StringBuilder ^ Insert(int index, double value);
public System.Text.StringBuilder Insert(int index, double value);
member this.Insert : int * double -> System.Text.StringBuilder
Public Function Insert (index As Integer, value As Double) As StringBuilder
Parameters
The position in this instance where insertion begins.
The value to insert.
ReturnsA reference to this instance after the insert operation has completed.
Exceptionsindex
is less than zero or greater than the length of this instance.
Enlarging the value of this instance would exceed MaxCapacity.
RemarksDouble.ToString is used to get a string representation of value
. Existing characters are shifted to make room for the new text. The capacity of this instance is adjusted as needed.
In the .NET Framework 3.5 Service Pack 1 and earlier versions, calls to this method threw an ArgumentOutOfRangeException if inserting value
would cause the object's total length to exceed MaxCapacity. Starting with the .NET Framework 4, the method throws an OutOfMemoryException.
Inserts the string representation of a decimal number into this instance at the specified character position.
public:
System::Text::StringBuilder ^ Insert(int index, System::Decimal value);
public System.Text.StringBuilder Insert(int index, decimal value);
member this.Insert : int * decimal -> System.Text.StringBuilder
Public Function Insert (index As Integer, value As Decimal) As StringBuilder
Parameters
The position in this instance where insertion begins.
ReturnsA reference to this instance after the insert operation has completed.
Exceptionsindex
is less than zero or greater than the length of this instance.
Enlarging the value of this instance would exceed MaxCapacity.
RemarksDecimal.ToString is used to get a string representation of value
. Existing characters are shifted to make room for the new text. The capacity of this instance is adjusted as needed.
In the .NET Framework 3.5 Service Pack 1 and earlier versions, calls to this method threw an ArgumentOutOfRangeException if inserting value
would cause the object's total length to exceed MaxCapacity. Starting with the .NET Framework 4, the method throws an OutOfMemoryException.
Inserts the string representation of a specified array of Unicode characters into this instance at the specified character position.
public:
System::Text::StringBuilder ^ Insert(int index, cli::array <char> ^ value);
public System.Text.StringBuilder Insert(int index, char[] value);
public System.Text.StringBuilder Insert(int index, char[]? value);
member this.Insert : int * char[] -> System.Text.StringBuilder
Public Function Insert (index As Integer, value As Char()) As StringBuilder
Parameters
The position in this instance where insertion begins.
The character array to insert.
ReturnsA reference to this instance after the insert operation has completed.
Exceptionsindex
is less than zero or greater than the length of this instance.
-or-
Enlarging the value of this instance would exceed MaxCapacity.
RemarksExisting characters are shifted to make room for the new text. The capacity of this instance is adjusted as needed.
If value
is null
, the StringBuilder is not changed.
Inserts the string representation of a specified Unicode character into this instance at the specified character position.
public:
System::Text::StringBuilder ^ Insert(int index, char value);
public System.Text.StringBuilder Insert(int index, char value);
member this.Insert : int * char -> System.Text.StringBuilder
Public Function Insert (index As Integer, value As Char) As StringBuilder
Parameters
The position in this instance where insertion begins.
The value to insert.
ReturnsA reference to this instance after the insert operation has completed.
Exceptionsindex
is less than zero or greater than the length of this instance.
-or-
Enlarging the value of this instance would exceed MaxCapacity.
RemarksChar.ToString is used to get a string representation of value
. Existing characters are shifted to make room for the new text. The capacity of this instance is adjusted as needed.
Inserts the string representation of a specified 8-bit unsigned integer into this instance at the specified character position.
public:
System::Text::StringBuilder ^ Insert(int index, System::Byte value);
public System.Text.StringBuilder Insert(int index, byte value);
member this.Insert : int * byte -> System.Text.StringBuilder
Public Function Insert (index As Integer, value As Byte) As StringBuilder
Parameters
The position in this instance where insertion begins.
The value to insert.
ReturnsA reference to this instance after the insert operation has completed.
Exceptionsindex
is less than zero or greater than the length of this instance.
Enlarging the value of this instance would exceed MaxCapacity.
RemarksByte.ToString is used to get a string representation of value
. Existing characters are shifted to make room for the new text. The capacity of this instance is adjusted as needed.
In the .NET Framework 3.5 Service Pack 1 and earlier versions, calls to this method threw an ArgumentOutOfRangeException if inserting value
would cause the object's total length to exceed MaxCapacity. Starting with the .NET Framework 4, the method throws an OutOfMemoryException.
Inserts the string representation of a Boolean value into this instance at the specified character position.
public:
System::Text::StringBuilder ^ Insert(int index, bool value);
public System.Text.StringBuilder Insert(int index, bool value);
member this.Insert : int * bool -> System.Text.StringBuilder
Public Function Insert (index As Integer, value As Boolean) As StringBuilder
Parameters
The position in this instance where insertion begins.
ReturnsA reference to this instance after the insert operation has completed.
Exceptionsindex
is less than zero or greater than the length of this instance.
Enlarging the value of this instance would exceed MaxCapacity.
RemarksBoolean.ToString is used to get a string representation of value
. Existing characters are shifted to make room for the new text. The capacity is adjusted as needed.
In the .NET Framework 3.5 Service Pack 1 and earlier versions, calls to this method threw an ArgumentOutOfRangeException if inserting value
would cause the object's total length to exceed MaxCapacity. Starting with the .NET Framework 4, the method throws an OutOfMemoryException.
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4