StringBuilder.Insert 方法

参考

定义

命名空间:: System.Text

程序集:: System.Runtime.dll

程序集:: mscorlib.dll

程序集:: netstandard.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

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

重载

Insert(Int32, SByte)	将指定的 8 位带符号整数的字符串表示形式插入到此实例中的指定字符位置。
Insert(Int32, Char[], Int32, Int32)	将指定的 Unicode 字符子数组的字符串表示形式插入到此实例中的指定字符位置。
Insert(Int32, String, Int32)	将指定字符串的一个或更多副本插入到此实例中的指定字符位置。
Insert(Int32, UInt64)	将 64 位无符号整数的字符串表示形式插入到此实例中的指定字符位置。
Insert(Int32, UInt32)	将 32 位无符号整数的字符串表示形式插入到此实例中的指定字符位置。
Insert(Int32, UInt16)	将 16 位无符号整数的字符串表示形式插入到此实例中的指定字符位置。
Insert(Int32, String)	将字符串插入到此实例中的指定字符位置。
Insert(Int32, Single)	将单精度浮点数的字符串表示形式插入到此实例中的指定字符位置。
Insert(Int32, ReadOnlySpan<Char>)	将字符序列插入到此实例中的指定字符位置。
Insert(Int32, Int16)	将指定的 16 位带符号整数的字符串表示形式插入到此实例中的指定字符位置。
Insert(Int32, Int64)	将 64 位带符号整数的字符串表示形式插入到此实例中的指定字符位置。
Insert(Int32, Int32)	将指定的 32 位带符号整数的字符串表示形式插入到此实例中的指定字符位置。
Insert(Int32, Object)	将对象的字符串表示形式插入到此实例中的指定字符位置。
Insert(Int32, Double)	将双精度浮点数的字符串表示形式插入到此实例中的指定字符位置。
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, SByte)

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

重要

此 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

要插入的值。

StringBuilder

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

属性: CLSCompliantAttribute

例外

ArgumentOutOfRangeException

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

OutOfMemoryException

增大此实例的值将超过 MaxCapacity。

注解

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

调用方说明

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

另请参阅

SByte

适用于

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

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

将指定的 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

要插入的字符数。

StringBuilder

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

例外

ArgumentNullException

value 为 null，且 startIndex 和 charCount 不为零。

ArgumentOutOfRangeException

index、startIndex 或 charCount 小于零。

- 或 -

index 大于此实例的长度。

- 或 -

startIndex 加 charCount 不是 value 中的位置。

- 或 -

增大此实例的值将超过 MaxCapacity。

注解

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

适用于

Insert(Int32, String, Int32)

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

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

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 的次数。

StringBuilder

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

例外

ArgumentOutOfRangeException

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

- 或 -

count 小于零。

OutOfMemoryException

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

注解

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

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

另请参阅

String

适用于

Insert(Int32, UInt64)

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

重要

此 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

要插入的值。

StringBuilder

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

属性: CLSCompliantAttribute

例外

ArgumentOutOfRangeException

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

OutOfMemoryException

增大此实例的值将超过 MaxCapacity。

注解

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

调用方说明

另请参阅

UInt64

适用于

Insert(Int32, UInt32)

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

重要

此 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

要插入的值。

StringBuilder

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

属性: CLSCompliantAttribute

例外

ArgumentOutOfRangeException

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

OutOfMemoryException

增大此实例的值将超过 MaxCapacity。

注解

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

调用方说明

另请参阅

UInt32

适用于

Insert(Int32, UInt16)

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

重要

此 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

要插入的值。

StringBuilder

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

属性: CLSCompliantAttribute

例外

ArgumentOutOfRangeException

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

OutOfMemoryException

增大此实例的值将超过 MaxCapacity。

注解

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

调用方说明

另请参阅

UInt16

适用于

Insert(Int32, String)

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

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

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

要插入的字符串。

StringBuilder

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

例外

ArgumentOutOfRangeException

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

- 或 -

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

注解

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

如果 value 为，则不更改的此实例StringBuilder，或者 value 不是null，但其长度为null零。

另请参阅

String

适用于

Insert(Int32, Single)

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

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

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

要插入的值。

StringBuilder

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

例外

ArgumentOutOfRangeException

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

OutOfMemoryException

增大此实例的值将超过 MaxCapacity。

注解

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

调用方说明

另请参阅

Single

适用于

Insert(Int32, ReadOnlySpan<Char>)

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

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

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>

要插入的字符范围。

StringBuilder

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

注解

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

适用于

Insert(Int32, Int16)

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

将指定的 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

要插入的值。

StringBuilder

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

例外

ArgumentOutOfRangeException

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

OutOfMemoryException

增大此实例的值将超过 MaxCapacity。

注解

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

调用方说明

另请参阅

Int16

适用于

Insert(Int32, Int64)

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

将 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

要插入的值。

StringBuilder

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

例外

ArgumentOutOfRangeException

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

OutOfMemoryException

增大此实例的值将超过 MaxCapacity。

注解

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

调用方说明

另请参阅

Int64

适用于

Insert(Int32, Int32)

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

将指定的 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

要插入的值。

StringBuilder

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

例外

ArgumentOutOfRangeException

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

OutOfMemoryException

增大此实例的值将超过 MaxCapacity。

注解

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

调用方说明

另请参阅

Int32

适用于

Insert(Int32, Object)

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

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

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。

StringBuilder

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

例外

ArgumentOutOfRangeException

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

OutOfMemoryException

增大此实例的值将超过 MaxCapacity。

注解

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

如果 value 为 null，则此实例的值保持不变。

调用方说明

另请参阅

Object

适用于

Insert(Int32, Double)

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

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

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

要插入的值。

StringBuilder

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

例外

ArgumentOutOfRangeException

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

OutOfMemoryException

增大此实例的值将超过 MaxCapacity。

注解

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

调用方说明

另请参阅

Double

适用于

Insert(Int32, Decimal)

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

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

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

要插入的值。

StringBuilder

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

例外

ArgumentOutOfRangeException

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

OutOfMemoryException

增大此实例的值将超过 MaxCapacity。

注解

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

调用方说明

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

另请参阅

Decimal

适用于

Insert(Int32, Char[])

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

将指定的 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[]

要插入的字符数组。

StringBuilder

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

例外

ArgumentOutOfRangeException

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

- 或 -

增大此实例的值将超过 MaxCapacity。

注解

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

如果 value 为 null， StringBuilder 则不会更改。

适用于

Insert(Int32, Char)

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

将指定的 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

要插入的值。

StringBuilder

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

例外

ArgumentOutOfRangeException

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

- 或 -

增大此实例的值将超过 MaxCapacity。

注解

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

另请参阅

Char

适用于

Insert(Int32, Byte)

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

将指定的 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

要插入的值。

StringBuilder

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

例外

ArgumentOutOfRangeException

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

OutOfMemoryException

增大此实例的值将超过 MaxCapacity。

注解

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

调用方说明

另请参阅

Byte

适用于

Insert(Int32, Boolean)

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

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

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

要插入的值。

StringBuilder

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

例外

ArgumentOutOfRangeException

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

OutOfMemoryException

增大此实例的值将超过 MaxCapacity。

注解

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

调用方说明

另请参阅

Boolean

适用于

通过

StringBuilder.Insert 方法

定义

重载

示例

Insert(Int32, SByte)

参数

返回

例外

注解

调用方说明

另请参阅

适用于

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

参数

返回

例外

注解

适用于

Insert(Int32, String, Int32)

参数

返回

例外

注解

另请参阅

适用于

Insert(Int32, UInt64)

参数

返回

例外

注解

调用方说明

另请参阅

适用于

Insert(Int32, UInt32)

参数

返回

例外

注解

调用方说明

另请参阅

适用于

Insert(Int32, UInt16)

参数

返回

例外

注解

调用方说明

另请参阅

适用于

Insert(Int32, String)

参数

返回

例外

注解

另请参阅

适用于

Insert(Int32, Single)

参数

返回

例外

注解

调用方说明

另请参阅

适用于

Insert(Int32, ReadOnlySpan<Char>)

参数

返回

注解

适用于

Insert(Int32, Int16)

参数

返回

例外

注解

调用方说明

另请参阅

适用于

Insert(Int32, Int64)

参数