StringBuilder.Insert 方法

定义

命名空间:: System.Text

程序集:: mscorlib.dll, System.Runtime.dll

程序集:: netstandard.dll, System.Runtime.dll

程序集:: System.Runtime.dll

程序集:: mscorlib.dll

程序集:: netstandard.dll

重要

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

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

重载

名称	说明
Insert(Int32, String, Int32)	将指定字符串的一个或多个副本插入到此实例中的指定字符位置。
Insert(Int32, UInt64)	将 64 位无符号整数的字符串表示形式插入到此实例中的指定字符位置。
Insert(Int32, UInt32)	将 32 位无符号整数的字符串表示形式插入到此实例中的指定字符位置。
Insert(Int32, UInt16)	将 16 位无符号整数的字符串表示形式插入到此实例中的指定字符位置。
Insert(Int32, Rune)
Insert(Int32, String)	将字符串插入到此实例中的指定字符位置。
Insert(Int32, Char[], Int32, Int32)	将 Unicode 字符的指定子数组的字符串表示形式插入到此实例中的指定字符位置。
Insert(Int32, Single)	将单精度浮点数的字符串表示形式插入此实例中的指定字符位置。
Insert(Int32, SByte)	将指定 8 位有符号整数的字符串表示形式插入到此实例中的指定字符位置。
Insert(Int32, ReadOnlySpan<Char>)	将字符序列插入到此实例中的指定字符位置。
Insert(Int32, Int16)	将指定 16 位带符号整数的字符串表示形式插入此实例中的指定字符位置。
Insert(Int32, Int64)	将 64 位带符号整数的字符串表示形式插入到此实例中的指定字符位置。
Insert(Int32, Int32)	将指定 32 位带符号整数的字符串表示形式插入到此实例中的指定字符位置。
Insert(Int32, Double)	将双精度浮点数的字符串表示形式插入到此实例中的指定字符位置。
Insert(Int32, Decimal)	将十进制数的字符串表示形式插入到此实例中的指定字符位置。
Insert(Int32, Char[])	将指定 Unicode 字符数组的字符串表示形式插入到此实例中的指定字符位置。
Insert(Int32, Char)	将指定 Unicode 字符的字符串表示形式插入到此实例中的指定字符位置。
Insert(Int32, Byte)	将指定 8 位无符号整数的字符串表示形式插入到此实例中的指定字符位置。
Insert(Int32, Boolean)	将布尔值的字符串表示形式插入到此实例中的指定字符位置。
Insert(Int32, Object)	将对象的字符串表示形式插入到此实例中的指定字符位置。

示例

以下示例演示了该方法 Insert 。

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, Int32)

Source:: StringBuilder.cs

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对象的当前长度加上超过MaxCapacity时间count长度value。

注解

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

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

另请参阅

String

适用于

Insert(Int32, UInt64)

Source:: StringBuilder.cs

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。将移动现有字符，为新文本腾出空间。此实例的容量会根据需要进行调整。

调用方说明

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

另请参阅

UInt64

适用于

Insert(Int32, UInt32)

Source:: StringBuilder.cs

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

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, Rune)

public:
 System::Text::StringBuilder ^ Insert(int index, System::Text::Rune value);

public System.Text.StringBuilder Insert(int index, System.Text.Rune value);

member this.Insert : int * System.Text.Rune -> System.Text.StringBuilder

Public Function Insert (index As Integer, value As Rune) As StringBuilder

参数

index: Int32

value: Rune

StringBuilder

适用于

Insert(Int32, String)

Source:: StringBuilder.cs

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对象的当前长度加上超过MaxCapacity的value长度。

注解

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

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

另请参阅

String

适用于

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

Source:: StringBuilder.cs

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，且startIndexcharCount不为零。

ArgumentOutOfRangeException

index、 startIndex或 charCount 小于零。

-或-

index 大于此实例的长度。

-或-

startIndex 加号 charCount 不是在内 value的位置。

-或-

扩大此实例的值将超出 MaxCapacity。

注解

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

适用于

Insert(Int32, Single)

Source:: StringBuilder.cs

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, SByte)

Source:: StringBuilder.cs

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。将移动现有字符，为新文本腾出空间。根据需要调整容量。

调用方说明

另请参阅

SByte

适用于

Insert(Int32, ReadOnlySpan<Char>)

Source:: StringBuilder.cs

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

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

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

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, Double)

Source:: StringBuilder.cs

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

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。将移动现有字符，为新文本腾出空间。此实例的容量会根据需要进行调整。

调用方说明

另请参阅

Decimal

适用于

Insert(Int32, Char[])

Source:: StringBuilder.cs

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。

注解

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

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

适用于

Insert(Int32, Char)

Source:: StringBuilder.cs

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

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

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

适用于

Insert(Int32, Object)

Source:: StringBuilder.cs

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。将移动现有字符，为新文本腾出空间。此实例的容量会根据需要进行调整。

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

调用方说明

另请参阅

Object

适用于

反馈

此页面是否有帮助？

通过

StringBuilder.Insert 方法

定义

重载

示例

Insert(Int32, String, Int32)

参数

返回

例外

注解

另请参阅

适用于

Insert(Int32, UInt64)

参数

返回

例外

注解

调用方说明

另请参阅

适用于

Insert(Int32, UInt32)

参数

返回

例外

注解

调用方说明

另请参阅

适用于

Insert(Int32, UInt16)

参数

返回

例外

注解

调用方说明

另请参阅

适用于

Insert(Int32, Rune)

参数

返回

适用于

Insert(Int32, String)

参数

返回

例外

注解

另请参阅

适用于

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

参数

返回

例外

注解

适用于

Insert(Int32, Single)

参数

返回

例外

注解

调用方说明

另请参阅

适用于

Insert(Int32, SByte)

参数

返回

例外

注解

调用方说明

另请参阅

适用于

Insert(Int32, ReadOnlySpan<Char>)

参数

返回

注解

适用于

Insert(Int32, Int16)

参数

返回

例外

注解

调用方说明