StringBuilder.Insert 方法

定义

将指定对象的字符串表示形式插入到此实例中的指定字符位置。

重载

Insert(Int32, String)

将字符串插入到此实例中的指定字符位置。

Insert(Int32, Single)

将单精度浮点数的字符串表示形式插入到此实例中的指定字符位置。

Insert(Int32, UInt16)

将 16 位无符号整数的字符串表示形式插入到此实例中的指定字符位置。

Insert(Int32, Int16)

将指定的 16 位带符号整数的字符串表示形式插入到此实例中的指定字符位置。

Insert(Int32, UInt64)

将 64 位无符号整数的字符串表示形式插入到此实例中的指定字符位置。

Insert(Int32, String, Int32)

将指定字符串的一个或更多副本插入到此实例中的指定字符位置。

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

将指定的 Unicode 字符子数组的字符串表示形式插入到此实例中的指定字符位置。

Insert(Int32, SByte)

将指定的 8 位带符号整数的字符串表示形式插入到此实例中的指定字符位置。

Insert(Int32, UInt32)

将 32 位无符号整数的字符串表示形式插入到此实例中的指定字符位置。

Insert(Int32, ReadOnlySpan<Char>)

将字符序列插入到此实例中的指定字符位置。

Insert(Int32, Double)

将双精度浮点数的字符串表示形式插入到此实例中的指定字符位置。

Insert(Int32, Int64)

将 64 位带符号整数的字符串表示形式插入到此实例中的指定字符位置。

Insert(Int32, Int32)

将指定的 32 位带符号整数的字符串表示形式插入到此实例中的指定字符位置。

Insert(Int32, Object)

将对象的字符串表示形式插入到此实例中的指定字符位置。

Insert(Int32, Decimal)

将十进制数的字符串表示形式插入到此实例中的指定字符位置。

Insert(Int32, Char[])

将指定的 Unicode 字符数组的字符串表示形式插入到此实例中的指定字符位置。

Insert(Int32, Char)

将指定的 Unicode 字符的字符串表示形式插入到此实例中的指定位置。

Insert(Int32, Byte)

将指定的 8 位无符号整数的字符串表示形式插入到此实例中的指定字符位置。

Insert(Int32, Boolean)

将布尔值的字符串表示形式插入到此实例中的指定字符位置。

示例

下面的示例演示 Insert 方法。

using namespace System;
using namespace System::Text;
ref class Sample
{
private:

   //                           index: 012345
   static String^ initialValue = "--[]--";
   static StringBuilder^ sb;

public:
   static void Main()
   {
      String^ xyz = "xyz";
      array<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.
      UInt16 xUInt16 = 8;
      UInt32 xUInt32 = 9;
      UInt64 xUInt64 = 10;
      SByte xSByte = -11;
      
      //
      Console::WriteLine( "StringBuilder.Insert method" );
      sb = gcnew 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 );
      
      //
   }

   static void Show( int overloadNumber, StringBuilder^ sbs )
   {
      Console::WriteLine( "{0,2:G} = {1}", overloadNumber, sbs );
      sb = gcnew StringBuilder( initialValue );
   }

};

int main()
{
   Sample::Main();
}

/*
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]--

*/
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, String)

将字符串插入到此实例中的指定字符位置。

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

参数

index
Int32

此实例中开始插入的位置。

value
String

要插入的字符串。

返回

完成插入操作后对此实例的引用。

例外

index 小于零或大于此实例的当前长度。

- 或 -

StringBuilder 对象的当前长度加上 value 的长度超过 MaxCapacity

注解

移动现有字符,为新文本腾出空间。 根据需要调整容量。

如果 nullvalue 为 ,则不会更改 的此实例StringBuilder,或者 valuenull为 ,但其长度为零。

另请参阅

适用于

Insert(Int32, Single)

将单精度浮点数的字符串表示形式插入到此实例中的指定字符位置。

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

参数

index
Int32

此实例中开始插入的位置。

value
Single

要插入的值。

返回

完成插入操作后对此实例的引用。

例外

index 小于零或大于此实例的长度。

增大此实例的值将超过 MaxCapacity

注解

Single.ToString 用于获取 的 value字符串表示形式。 移动现有字符,为新文本腾出空间。 此实例的容量会根据需要进行调整。

调用方说明

在 .NET Framework 3.5 Service Pack 1 及更早版本中,如果插入value会导致对象的总长度超过 MaxCapacity,则对此方法的调用会引发 ArgumentOutOfRangeException 。 从 .NET Framework 4 开始, 方法引发 OutOfMemoryException

另请参阅

适用于

Insert(Int32, UInt16)

重要

此 API 不符合 CLS。

将 16 位无符号整数的字符串表示形式插入到此实例中的指定字符位置。

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

参数

index
Int32

此实例中开始插入的位置。

value
UInt16

要插入的值。

返回

完成插入操作后对此实例的引用。

属性

例外

index 小于零或大于此实例的长度。

增大此实例的值将超过 MaxCapacity

注解

UInt16.ToString 用于获取 的 value字符串表示形式。 移动现有字符,为新文本腾出空间。 此实例的容量会根据需要进行调整。

调用方说明

在 .NET Framework 3.5 Service Pack 1 及更早版本中,如果插入value会导致对象的总长度超过 MaxCapacity,则对此方法的调用会引发 ArgumentOutOfRangeException 。 从 .NET Framework 4 开始, 方法引发 OutOfMemoryException

另请参阅

适用于

Insert(Int32, Int16)

将指定的 16 位带符号整数的字符串表示形式插入到此实例中的指定字符位置。

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

参数

index
Int32

此实例中开始插入的位置。

value
Int16

要插入的值。

返回

完成插入操作后对此实例的引用。

例外

index 小于零或大于此实例的长度。

增大此实例的值将超过 MaxCapacity

注解

Int16.ToString 用于获取 的 value字符串表示形式。 移动现有字符,为新文本腾出空间。 此实例的容量会根据需要进行调整。

调用方说明

在 .NET Framework 3.5 Service Pack 1 及更早版本中,如果插入value会导致对象的总长度超过 MaxCapacity,则对此方法的调用会引发 ArgumentOutOfRangeException 。 从 .NET Framework 4 开始, 方法引发 OutOfMemoryException

另请参阅

适用于

Insert(Int32, UInt64)

重要

此 API 不符合 CLS。

将 64 位无符号整数的字符串表示形式插入到此实例中的指定字符位置。

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

参数

index
Int32

此实例中开始插入的位置。

value
UInt64

要插入的值。

返回

完成插入操作后对此实例的引用。

属性

例外

index 小于零或大于此实例的长度。

增大此实例的值将超过 MaxCapacity

注解

UInt64.ToString 用于获取 的 value字符串表示形式。 移动现有字符,为新文本腾出空间。 此实例的容量会根据需要进行调整。

调用方说明

在 .NET Framework 3.5 Service Pack 1 及更早版本中,如果插入value会导致对象的总长度超过 MaxCapacity,则对此方法的调用会引发 ArgumentOutOfRangeException 。 从 .NET Framework 4 开始, 方法引发 OutOfMemoryException

另请参阅

适用于

Insert(Int32, String, Int32)

将指定字符串的一个或更多副本插入到此实例中的指定字符位置。

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

参数

index
Int32

此实例中开始插入的位置。

value
String

要插入的字符串。

count
Int32

要插入 value 的次数。

返回

完成插入后对此实例的引用。

例外

index 小于零或大于此实例的当前长度。

- 或 -

count 小于零。

StringBuilder 对象的当前长度加上 value 的长度乘以 count,超过了 MaxCapacity

注解

移动现有字符,为新文本腾出空间。 根据需要调整此实例的容量。

如果 为 ,则null不更改此StringBuilder对象,value但其长度为零或count零。nullvalue

另请参阅

适用于

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

将指定的 Unicode 字符子数组的字符串表示形式插入到此实例中的指定字符位置。

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

参数

index
Int32

此实例中开始插入的位置。

value
Char[]

字符数组。

startIndex
Int32

value 内的起始索引。

charCount
Int32

要插入的字符数。

返回

完成插入操作后对此实例的引用。

例外

valuenull,且 startIndexcharCount 不为零。

indexstartIndexcharCount 小于零。

- 或 -

index 大于此实例的长度。

- 或 -

startIndexcharCount 不是 value 中的位置。

- 或 -

增大此实例的值将超过 MaxCapacity

注解

移动现有字符,为新文本腾出空间。 根据需要调整此实例的容量。

适用于

Insert(Int32, SByte)

重要

此 API 不符合 CLS。

将指定的 8 位带符号整数的字符串表示形式插入到此实例中的指定字符位置。

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

参数

index
Int32

此实例中开始插入的位置。

value
SByte

要插入的值。

返回

完成插入操作后对此实例的引用。

属性

例外

index 小于零或大于此实例的长度。

增大此实例的值将超过 MaxCapacity

注解

SByte.ToString 用于获取 的 value字符串表示形式。 移动现有字符,为新文本腾出空间。 根据需要调整容量。

调用方说明

在 .NET Framework 3.5 Service Pack 1 及更早版本中,如果插入value会导致对象的总长度超过 MaxCapacity,则对此方法的调用会引发 ArgumentOutOfRangeException 。 从 .NET Framework 4 开始,方法将OutOfMemoryException引发 。

另请参阅

适用于

Insert(Int32, UInt32)

重要

此 API 不符合 CLS。

将 32 位无符号整数的字符串表示形式插入到此实例中的指定字符位置。

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

参数

index
Int32

此实例中开始插入的位置。

value
UInt32

要插入的值。

返回

完成插入操作后对此实例的引用。

属性

例外

index 小于零或大于此实例的长度。

增大此实例的值将超过 MaxCapacity

注解

UInt32.ToString 用于获取 的 value字符串表示形式。 移动现有字符,为新文本腾出空间。 根据需要调整此实例的容量。

调用方说明

在 .NET Framework 3.5 Service Pack 1 及更早版本中,如果插入value会导致对象的总长度超过 MaxCapacity,则对此方法的调用会引发 ArgumentOutOfRangeException 。 从 .NET Framework 4 开始,方法将OutOfMemoryException引发 。

另请参阅

适用于

Insert(Int32, ReadOnlySpan<Char>)

将字符序列插入到此实例中的指定字符位置。

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

参数

index
Int32

此实例中开始插入的位置。

value
ReadOnlySpan<Char>

要插入的字符范围。

返回

完成插入操作后对此实例的引用。

注解

移动现有字符,为 中的 value 字符序列腾出空间以插入它。 根据需要调整容量。

适用于

Insert(Int32, Double)

将双精度浮点数的字符串表示形式插入到此实例中的指定字符位置。

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

参数

index
Int32

此实例中开始插入的位置。

value
Double

要插入的值。

返回

完成插入操作后对此实例的引用。

例外

index 小于零或大于此实例的长度。

增大此实例的值将超过 MaxCapacity

注解

Double.ToString 用于获取 的 value字符串表示形式。 移动现有字符,为新文本腾出空间。 根据需要调整此实例的容量。

调用方说明

在 .NET Framework 3.5 Service Pack 1 及更早版本中,如果插入value会导致对象的总长度超过 MaxCapacity,则对此方法的调用会引发 ArgumentOutOfRangeException 。 从 .NET Framework 4 开始,方法将OutOfMemoryException引发 。

另请参阅

适用于

Insert(Int32, Int64)

将 64 位带符号整数的字符串表示形式插入到此实例中的指定字符位置。

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

参数

index
Int32

此实例中开始插入的位置。

value
Int64

要插入的值。

返回

完成插入操作后对此实例的引用。

例外

index 小于零或大于此实例的长度。

增大此实例的值将超过 MaxCapacity

注解

Int64.ToString 用于获取 的 value字符串表示形式。 移动现有字符,为新文本腾出空间。 根据需要调整此实例的容量。

调用方说明

在 .NET Framework 3.5 Service Pack 1 及更早版本中,如果插入value会导致对象的总长度超过 MaxCapacity,则对此方法的调用会引发 ArgumentOutOfRangeException 。 从 .NET Framework 4 开始,方法将OutOfMemoryException引发 。

另请参阅

适用于

Insert(Int32, Int32)

将指定的 32 位带符号整数的字符串表示形式插入到此实例中的指定字符位置。

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

参数

index
Int32

此实例中开始插入的位置。

value
Int32

要插入的值。

返回

完成插入操作后对此实例的引用。

例外

index 小于零或大于此实例的长度。

增大此实例的值将超过 MaxCapacity

注解

Int32.ToString 用于获取 的 value字符串表示形式。 移动现有字符,为新文本腾出空间。 根据需要调整此实例的容量。

调用方说明

在 .NET Framework 3.5 Service Pack 1 及更早版本中,如果插入value会导致对象的总长度超过 MaxCapacity,则对此方法的调用会引发 ArgumentOutOfRangeException 。 从 .NET Framework 4 开始,方法将OutOfMemoryException引发 。

另请参阅

适用于

Insert(Int32, Object)

将对象的字符串表示形式插入到此实例中的指定字符位置。

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

参数

index
Int32

此实例中开始插入的位置。

value
Object

要插入的对象,或 null

返回

完成插入操作后对此实例的引用。

例外

index 小于零或大于此实例的长度。

增大此实例的值将超过 MaxCapacity

注解

Object.ToString 用于获取 的 value字符串表示形式。 移动现有字符,为新文本腾出空间。 根据需要调整此实例的容量。

如果 valuenull,则此实例的值保持不变。

调用方说明

在 .NET Framework 3.5 Service Pack 1 及更早版本中,如果插入value会导致对象的总长度超过 MaxCapacity,则对此方法的调用会引发 ArgumentOutOfRangeException 。 从 .NET Framework 4 开始,方法将OutOfMemoryException引发 。

另请参阅

适用于

Insert(Int32, Decimal)

将十进制数的字符串表示形式插入到此实例中的指定字符位置。

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

参数

index
Int32

此实例中开始插入的位置。

value
Decimal

要插入的值。

返回

完成插入操作后对此实例的引用。

例外

index 小于零或大于此实例的长度。

增大此实例的值将超过 MaxCapacity

注解

Decimal.ToString 用于获取 的 value字符串表示形式。 移动现有字符,为新文本腾出空间。 此实例的容量会根据需要进行调整。

调用方说明

在 .NET Framework 3.5 Service Pack 1 及更早版本中,如果插入value会导致对象的总长度超过 MaxCapacity,则对此方法的调用会引发 ArgumentOutOfRangeException 。 从 .NET Framework 4 开始, 方法引发 OutOfMemoryException

另请参阅

适用于

Insert(Int32, Char[])

将指定的 Unicode 字符数组的字符串表示形式插入到此实例中的指定字符位置。

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

参数

index
Int32

此实例中开始插入的位置。

value
Char[]

要插入的字符数组。

返回

完成插入操作后对此实例的引用。

例外

index 小于零或大于此实例的长度。

- 或 -

增大此实例的值将超过 MaxCapacity

注解

移动现有字符,为新文本腾出空间。 此实例的容量会根据需要进行调整。

如果 valuenullStringBuilder 则 不会更改 。

适用于

Insert(Int32, Char)

将指定的 Unicode 字符的字符串表示形式插入到此实例中的指定位置。

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

参数

index
Int32

此实例中开始插入的位置。

value
Char

要插入的值。

返回

完成插入操作后对此实例的引用。

例外

index 小于零或大于此实例的长度。

- 或 -

增大此实例的值将超过 MaxCapacity

注解

Char.ToString 用于获取 的 value字符串表示形式。 移动现有字符,为新文本腾出空间。 此实例的容量会根据需要进行调整。

另请参阅

适用于

Insert(Int32, Byte)

将指定的 8 位无符号整数的字符串表示形式插入到此实例中的指定字符位置。

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

参数

index
Int32

此实例中开始插入的位置。

value
Byte

要插入的值。

返回

完成插入操作后对此实例的引用。

例外

index 小于零或大于此实例的长度。

增大此实例的值将超过 MaxCapacity

注解

Byte.ToString 用于获取 的 value字符串表示形式。 移动现有字符,为新文本腾出空间。 此实例的容量会根据需要进行调整。

调用方说明

在 .NET Framework 3.5 Service Pack 1 及更早版本中,如果插入value会导致对象的总长度超过 MaxCapacity,则对此方法的调用会引发 ArgumentOutOfRangeException 。 从 .NET Framework 4 开始, 方法引发 OutOfMemoryException

另请参阅

适用于

Insert(Int32, Boolean)

将布尔值的字符串表示形式插入到此实例中的指定字符位置。

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

参数

index
Int32

此实例中开始插入的位置。

value
Boolean

要插入的值。

返回

完成插入操作后对此实例的引用。

例外

index 小于零或大于此实例的长度。

增大此实例的值将超过 MaxCapacity

注解

Boolean.ToString 用于获取 的 value字符串表示形式。 移动现有字符,为新文本腾出空间。 根据需要调整容量。

调用方说明

在 .NET Framework 3.5 Service Pack 1 及更早版本中,如果插入value会导致对象的总长度超过 MaxCapacity,则对此方法的调用会引发 ArgumentOutOfRangeException 。 从 .NET Framework 4 开始, 方法引发 OutOfMemoryException

另请参阅

适用于